home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 414_03 / the.man < prev    next >
Encoding:
Text File  |  1993-11-28  |  124.8 KB  |  4,370 lines
  1.                            THE - The Hessling Editor
  2.      
  3.      OVERVIEW
  4.      ========
  5.      
  6.      THE is a text editor that uses both command line commands and key bindings
  7.      to operate. It is intended to be similar to the VM/CMS System Product 
  8.      Editor, XEDIT and to Mansfield Software's, KEDIT.
  9.      
  10.      The screen display consists of several windows:
  11.         - a main body window which displays the contents of the file being
  12.           editted,
  13.         - a command line from which commands may be issued,
  14.         - an optional prefix window which shows line numbers and from
  15.           which prefix commands can be issued
  16.         - an id window which displays the file name, row/col etc. for the
  17.           current file and
  18.         - a status line which indicates global status info like number of files
  19.           being editted, time etc.
  20.      
  21.      An important distinction must be made between what is called the current
  22.      line and the focus line. The focus line is that line in the main body in
  23.      which the cursor is displayed. All commands bound to function keys use the
  24.      focus line as the initial line from which to begin executing the command.
  25.      Commands issued from the command line use the current line as the starting
  26.      line for execution of commands. The current line is the line in the main
  27.      body that is highlighted; by default line 7.
  28.      
  29.      To move between the command line and the main body the 'tabcmd' command is
  30.      used. By default it is bound to the Home key (on PCs), the Do key
  31.      (on vt220s) and F12 (on xterms). If you prefer the XEDIT feel for arrow
  32.      keys, issue the 'set CMDArrow TAB TAB TAB' command from the command line.
  33.      
  34.      To determine what keys are bound to what commands, type 'show' followed 
  35.      by Return on the command line, then follow the directions displayed.
  36.      Key bindings may be changed for the current session by using the 'define'
  37.      command.
  38.      
  39.      PROFILE FILE
  40.      ============
  41.      
  42.      Various session defaults may be changed on startup for an individual by
  43.      using a profile file. This file contains various commands that set the
  44.      current environment, including key bindings. This profile file can also be
  45.      used to process commands in batch mode. For example, to change all
  46.      occurrences of 'alligator' to 'crocodile' in the file file.ext in batch
  47.      mode, a profile file (prf.prf) with the following commands would be used:
  48.      
  49.           'c/alligator/crocodile/ * *'
  50.           'file'
  51.      
  52.      and the command
  53.      
  54.           the -p prf.prf file.ext
  55.      
  56.      would be issued.
  57.      
  58.      This changes the first string enclosed in delimiters (either /,\ or @) to
  59.      the second string for every line (*) starting at the current line
  60.      (0 initially) changing each occurrence on a line (*).
  61.      Maybe you only want to change a string after the first line that contains
  62.      the string 'donkey', but only change the second occurrence of that string.
  63.      The profile commands would then be:
  64.      
  65.           '/donkey/'
  66.           'c/alligator/crocodile/ * 1 2'
  67.           'file'
  68.      
  69.      The change command uses a 'target' specification as its first parameter
  70.      after the string details. A target can be a number of lines, an absolute
  71.      line number or a string.
  72.      Number of line targets consist of either a positive integer, for
  73.      referencing lines toward the end of the file, negative for referencing
  74.      toward the start of the file or '*', which is all the remaining lines in
  75.      the file or '-*' which is all lines toward the start of the file.
  76.      An absolute line number in the form of ':n' is the line number in a file,
  77.      starting with line number 1.
  78.      A target is any string within the allowable target delimiters.
  79.      
  80.      For more information on default key bindings see the *.hlp files. Detailed
  81.      documentation of each command is present in each of the comm*.c files.
  82.      
  83.      --------------------------------------------------------------------------
  84.      
  85.      
  86.      ========================================================================
  87.      COMMAND REFERENCE
  88.      ========================================================================
  89.  
  90.  
  91.  
  92.      --------------------------------------------------------------------------
  93.      COMMAND
  94.           add - add blank line
  95.      
  96.      SYNTAX
  97.           ADD [n]
  98.      
  99.      DESCRIPTION
  100.           The ADD command inserts the specified number of blank lines after
  101.           the current_line (if issued from the command line) or after the
  102.           focus_line (if issued in the main of prefix windows).
  103.           The cursor is positioned in the column corresponding to the first
  104.           column not containing a space in the line above.
  105.      
  106.      COMPATIBILITY
  107.           XEDIT: Compatible.
  108.           KEDIT: Compatible.
  109.      
  110.      DEFAULT
  111.           With no parameters, 1 line is added.
  112.      
  113.      SEE ALSO
  114.           SOS ADDLINE
  115.      
  116.      STATUS
  117.           Complete
  118.  
  119.  
  120.  
  121.      --------------------------------------------------------------------------
  122.      COMMAND
  123.           all - select and display restricted set of lines
  124.      
  125.      SYNTAX
  126.           ALL [string target]
  127.      
  128.      DESCRIPTION
  129.      
  130.      COMPATIBILITY
  131.           XEDIT: Compatible.
  132.           KEDIT: Compatible.
  133.      
  134.      DEFAULT
  135.      
  136.      SEE ALSO
  137.      
  138.      STATUS
  139.           Not Started
  140.  
  141.  
  142.  
  143.      --------------------------------------------------------------------------
  144.      COMMAND
  145.           backward - scroll backwards one screen
  146.      
  147.      SYNTAX
  148.           BAckward [n|*]
  149.      
  150.      DESCRIPTION
  151.           The BACKWARD command scrolls the file contents backwards through
  152.           the file [n|*] screens.
  153.      
  154.      COMPATIBILITY
  155.           XEDIT: Compatible.
  156.           KEDIT: Does not support HALF or Lines options.
  157.      
  158.      DEFAULT
  159.           With no parameters, 1 screen is scrolled.
  160.      
  161.      SEE ALSO
  162.           forward,top
  163.      
  164.      STATUS
  165.           Complete
  166.  
  167.  
  168.  
  169.      --------------------------------------------------------------------------
  170.      COMMAND
  171.           bottom - move to the bottom of the file
  172.      
  173.      SYNTAX
  174.           BOTtom
  175.      
  176.      DESCRIPTION
  177.           The BOTTOM command moves to the very end of the current file.
  178.           The last line of the file is set to the current_line.
  179.      
  180.      COMPATIBILITY
  181.           XEDIT: Compatible.
  182.           KEDIT: Compatible.
  183.      
  184.      SEE ALSO
  185.           forward,top
  186.      
  187.      STATUS
  188.           Complete
  189.  
  190.  
  191.  
  192.      --------------------------------------------------------------------------
  193.      COMMAND
  194.           cancel - quickly exit from THE
  195.      
  196.      SYNTAX
  197.           CANcel
  198.      
  199.      DESCRIPTION
  200.           The CANCEL command exits from THE quickly by QQUITting out of all
  201.           files currently in the ring that do not have any outstanding
  202.           alterations.
  203.      
  204.      COMPATIBILITY
  205.           XEDIT: Compatible.
  206.           KEDIT: Compatible.
  207.      
  208.      SEE ALSO
  209.           ccancel
  210.      
  211.      STATUS
  212.           Complete.
  213.  
  214.  
  215.  
  216.      --------------------------------------------------------------------------
  217.      COMMAND
  218.           ccancel - quickly exit from THE
  219.      
  220.      SYNTAX
  221.           CCancel
  222.      
  223.      DESCRIPTION
  224.           The CCANCEL command exits from THE quickly by QQUITting out of all
  225.           files currently in the ring. Any changes made to any of the files
  226.           will be lost.
  227.      
  228.      COMPATIBILITY
  229.           XEDIT: N/A
  230.           KEDIT: N/A
  231.      
  232.      SEE ALSO
  233.           cancel
  234.      
  235.      STATUS
  236.           Complete.
  237.  
  238.  
  239.  
  240.      --------------------------------------------------------------------------
  241.      COMMAND
  242.           change - change file text
  243.      
  244.      SYNTAX
  245.           Change /string1/string2/ [target] [n] [m]
  246.      
  247.      DESCRIPTION
  248.           The CHANGE command changes one string of text to another.
  249.      
  250.           The first parameter to the change command is the old and new
  251.           string values, seperated by delimiters.
  252.           The allowable delimiters are '/' '\' and '@'.
  253.      
  254.           The second parameter is the target; how many lines are to be
  255.           searched for occurrences of the first string to be changed.
  256.      
  257.           The third parameter determines how many occurrences of 'string1'
  258.           are to be changed on each line.
  259.      
  260.           The fourth parameter determines at which occurrences of 'string1'
  261.           on the line are changes to commence.
  262.      
  263.      COMPATIBILITY
  264.           XEDIT: Compatible.
  265.           KEDIT: Compatible.
  266.      
  267.      DEFAULT
  268.           1 1 1
  269.      
  270.      SEE ALSO
  271.           schange
  272.      
  273.      STATUS
  274.           Complete.
  275.  
  276.  
  277.  
  278.      --------------------------------------------------------------------------
  279.      COMMAND
  280.           cmatch - find matching bracket character
  281.      
  282.      SYNTAX
  283.           ** effective only if bound to a key **
  284.      
  285.      DESCRIPTION
  286.           The CMATCH command searches for the matching bracket character to
  287.           the character under the cursor.
  288.      
  289.           It handles nested sets of matching pairs.
  290.           The matching character pairs are '[]{}<>()'.
  291.      
  292.      COMPATIBILITY
  293.           XEDIT: N/A
  294.           KEDIT: Compatible.
  295.      
  296.      STATUS
  297.           Complete.
  298.  
  299.  
  300.  
  301.      --------------------------------------------------------------------------
  302.      COMMAND
  303.           cmsg - display text on command line
  304.      
  305.      SYNTAX
  306.           CMSG [text]
  307.      
  308.      DESCRIPTION
  309.           The CMSG command, primarily used in macros, displays text on the
  310.           command line.
  311.      
  312.      COMPATIBILITY
  313.           XEDIT: Compatible.
  314.           KEDIT: Compatible.
  315.      
  316.      SEE ALSO
  317.           EMSG, MSG
  318.      
  319.      STATUS
  320.           Complete.
  321.  
  322.  
  323.  
  324.      --------------------------------------------------------------------------
  325.      COMMAND
  326.           command - execute a command without synonym translation
  327.      
  328.      SYNTAX
  329.           COMMAND command [options]
  330.      
  331.      DESCRIPTION
  332.           The COMMAND command executes the specified command without
  333.           synonym translation. THE does not attempt to execute the command
  334.           as a macro even if IMPMACRO is ON. The command will be passed
  335.           to the operating system if IMPOS is ON.
  336.      
  337.      COMPATIBILITY
  338.           XEDIT: Compatible.
  339.           KEDIT: Compatible.
  340.      
  341.      STATUS
  342.           Complete.
  343.  
  344.  
  345.  
  346.      --------------------------------------------------------------------------
  347.      COMMAND
  348.           control_char - allow control characters to be entered
  349.      
  350.      SYNTAX
  351.           ** effective only if bound to a key **
  352.      
  353.      DESCRIPTION
  354.           The CONTROL_CHAR command prompts the user to enter a control character.
  355.      
  356.      COMPATIBILITY
  357.           XEDIT: N/A
  358.           KEDIT: N/A
  359.      
  360.      STATUS
  361.           Complete.
  362.  
  363.  
  364.  
  365.      --------------------------------------------------------------------------
  366.      COMMAND
  367.           copy - copies text from one position to another
  368.      
  369.      SYNTAX
  370.           COPY target1 target2
  371.            or
  372.           COPY BLOCK [RESET]
  373.      
  374.      DESCRIPTION
  375.           With the first form of the COPY command, text is copied from the
  376.           first target area to the line specified by target2. Text can
  377.           only be copied within the same view of the file.
  378.      
  379.           The second form of the COPY command copies text within the
  380.           currently marked block to the current cursor position.
  381.           The text can be in the same file or a different file.
  382.      
  383.      COMPATIBILITY
  384.           The first form of the COPY command has not yet been implemented.
  385.           XEDIT: Not implemented.
  386.           KEDIT: Adds extra functionality with [RESET] option.
  387.                  With the cursor in the marked block this command in KEDIT
  388.                  acts like DUPLICATE BLOCK.
  389.      
  390.      STATUS
  391.           Complete.
  392.  
  393.  
  394.  
  395.      --------------------------------------------------------------------------
  396.      COMMAND
  397.           define - assign one or many commands to a key
  398.      
  399.      SYNTAX
  400.           DEFine key-name [command [args] [[#command [args]...]]]
  401.      
  402.      DESCRIPTION
  403.           The DEFINE command allows the user to assign one or many 
  404.           commands and optional parameter(s) to a key. 
  405.      
  406.           Commands may be abbreviated.
  407.      
  408.           If multiple commands are assigned, then the LINEND setting
  409.           must be ON and the LINEND character must match the character
  410.           that delimits the commands at the time that the DEFINE command
  411.           is executed and at the time the key is pressed.
  412.      
  413.           With no arguments, any existing definition for that key is
  414.           removed and the key reverts back to its default assignation (if
  415.           it had any).
  416.      
  417.           key-names correspond to the key name shown with the SHOW command.
  418.      
  419.      COMPATIBILITY
  420.           XEDIT: N/A
  421.           KEDIT: Minimal. No support for in-memory macro commands.
  422.                  KEDIT does not allow multiple commands except as KEXX
  423.                  macros.
  424.      
  425.      SEE ALSO
  426.           SHOW
  427.      
  428.      STATUS
  429.           Complete.
  430.  
  431.  
  432.  
  433.      --------------------------------------------------------------------------
  434.      COMMAND
  435.           delete - delete lines from a file
  436.      
  437.      SYNTAX
  438.           DELete [target|BLOCK]
  439.      
  440.      DESCRIPTION
  441.           The DELETE command allows the user remove lines from the current
  442.           file. The number of lines removed depends on the target specified.
  443.           Lines are removed starting with the current_line.
  444.      
  445.      COMPATIBILITY
  446.           XEDIT: BLOCK option not supported in XEDIT.
  447.           KEDIT: Compatible.
  448.      
  449.      DEFAULT
  450.           1 (the current line)
  451.      
  452.      SEE ALSO
  453.           SOS DELETE
  454.      
  455.      STATUS
  456.           Complete.
  457.  
  458.  
  459.  
  460.      --------------------------------------------------------------------------
  461.      COMMAND
  462.           directory - list the specified directory
  463.      
  464.      SYNTAX
  465.           DIRectory [directory]
  466.      
  467.      DESCRIPTION
  468.           The DIRECTORY command displays all files in the specified directory.
  469.           When no parameter is supplied, the current directory is displayed.
  470.      
  471.      COMPATIBILITY
  472.           XEDIT: N/A
  473.           KEDIT: Compatible.
  474.      
  475.      STATUS
  476.           Complete.
  477.  
  478.  
  479.  
  480.      --------------------------------------------------------------------------
  481.      COMMAND
  482.           down_arrow - move the cursor down one line
  483.      
  484.      SYNTAX
  485.           ** effective only if bound to a key **
  486.      
  487.      DESCRIPTION
  488.           The down_arrow command moves the cursor down one line in the main
  489.           window. Scrolling of the window occurs if the cursor is on the last
  490.           line of the window and CMDARROWS ... SCROLL is set (the default),
  491.           otherwise the cursor returns to the command line.
  492.      
  493.           When on the command line, this command moves forward through the
  494.           list of previous command line commands if CMDARROWS RETRIEVE ...
  495.           is set or tabs to the first line of the main window if 
  496.           CMDARROWS TAB ... is set.
  497.      
  498.      COMPATIBILITY
  499.           XEDIT: N/A
  500.           KEDIT: Equivalent of CURSOR DOWN.
  501.      
  502.      SEE ALSO
  503.           Up_arrow
  504.      
  505.      STATUS
  506.           Complete.
  507.  
  508.  
  509.  
  510.      --------------------------------------------------------------------------
  511.      COMMAND
  512.           duplicate - duplicate lines
  513.      
  514.      SYNTAX
  515.           DUPlicate [n [target|BLOCK]]
  516.      
  517.      DESCRIPTION
  518.           The DUPLICATE command copies the number of lines extrapolated from
  519.           target, n times.
  520.      
  521.      COMPATIBILITY
  522.           XEDIT: Equivalent of DUPLICAT command.
  523.           KEDIT: Compatible.
  524.      
  525.      STATUS
  526.           Complete.
  527.  
  528.  
  529.  
  530.      --------------------------------------------------------------------------
  531.      COMMAND
  532.           emsg - display error message
  533.      
  534.      SYNTAX
  535.           EMSG [message]
  536.      
  537.      DESCRIPTION
  538.           The EMSG command displays an error message on the error line.
  539.           This command is usually issued from a macro file.
  540.      
  541.      COMPATIBILITY
  542.           XEDIT: Does not support [mmmnnns text] option
  543.           KEDIT: Compatible
  544.      
  545.      SEE ALSO
  546.           EMSG
  547.      
  548.      STATUS
  549.           Complete.
  550.  
  551.  
  552.  
  553.      --------------------------------------------------------------------------
  554.      COMMAND
  555.           enter - execute a command
  556.      
  557.      SYNTAX
  558.           ** effective only if bound to a key **
  559.      
  560.      DESCRIPTION
  561.           The ENTER command executes the command currently displayed on the
  562.           command line, if the cursor is currently displayed there.
  563.           If the key associated with ENTER is pressed while in the main or
  564.           prefix window, then the cursor will move to the first column of the
  565.           next line. If the mode is currently in 'insert', then a new line
  566.           is added and the cursor placed at the first column of the new line.
  567.      
  568.      COMPATIBILITY
  569.           XEDIT: N/A
  570.           KEDIT: N/A
  571.      
  572.      STATUS
  573.           Complete.
  574.  
  575.  
  576.  
  577.      --------------------------------------------------------------------------
  578.      COMMAND
  579.           expand - expand tab characters to spaces
  580.      
  581.      SYNTAX
  582.           EXPand [target]
  583.      
  584.      DESCRIPTION
  585.           The EXPAND command converts all tab characters to spaces depending
  586.           on the size of a tab determined by [SET] TABS command.
  587.      
  588.      COMPATIBILITY
  589.           XEDIT: Compatible.
  590.           KEDIT: Compatible.
  591.      
  592.      STATUS
  593.           Complete.
  594.  
  595.  
  596.  
  597.      --------------------------------------------------------------------------
  598.      COMMAND
  599.           extract - obtain setting information from THE
  600.      
  601.      SYNTAX
  602.           EXTract /item/[...]
  603.      
  604.      DESCRIPTION
  605.           The EXTRACT command is used to relay information about settings
  606.           within the from within a REXX macro. EXTRACT is only valid within
  607.           a REXX macro.
  608.      
  609.      COMPATIBILITY
  610.           XEDIT: Only allows '/' as delimiter.
  611.           KEDIT: Only allows '/' as delimiter.
  612.      
  613.      STATUS
  614.           Complete.
  615.  
  616.  
  617.  
  618.      --------------------------------------------------------------------------
  619.      COMMAND
  620.           ffile - force file the current file to disk
  621.      
  622.      SYNTAX
  623.           FFile  [filename]
  624.      
  625.      DESCRIPTION
  626.           The FFILE command writes the current file to disk to the current
  627.           file name or to the supplied filename.
  628.           Unlike the FILE command, if the optional filename exists, this
  629.           command will overwrite the file.
  630.      
  631.      COMPATIBILITY
  632.           XEDIT: N/A
  633.           KEDIT: Compatible.
  634.      
  635.      DEFAULT
  636.           With no parameters, the current file is written.
  637.      
  638.      SEE ALSO
  639.           file,save,ssave
  640.      
  641.      STATUS
  642.           Complete
  643.  
  644.  
  645.  
  646.      --------------------------------------------------------------------------
  647.      COMMAND
  648.           file - file the current file to disk
  649.      
  650.      SYNTAX
  651.           FILE  [filename]
  652.      
  653.      DESCRIPTION
  654.           The FILE command writes the current file to disk to the current
  655.           file name or to the supplied filename.
  656.           Unlike the FFILE command, if the optional filename exists, this
  657.           command will not overwrite the file.
  658.      
  659.      COMPATIBILITY
  660.           XEDIT: Compatible.
  661.           KEDIT: Compatible.
  662.      
  663.      DEFAULT
  664.           With no parameters, the current file is written.
  665.      
  666.      SEE ALSO
  667.           ffile,save,ssave
  668.      
  669.      STATUS
  670.           Complete
  671.  
  672.  
  673.  
  674.      --------------------------------------------------------------------------
  675.      COMMAND
  676.           fillbox - fill the marked box block with a character
  677.      
  678.      SYNTAX
  679.           FILLbox [c]
  680.      
  681.      DESCRIPTION
  682.           The FILLBOX command fills the marked block with the specified
  683.           character. If no parameters are supplied and the command is run
  684.           from the command line, then the box will be filled with spaces.
  685.           If the command is not run from the command line, the user is
  686.           prompted for a character to fill the box.
  687.      
  688.      COMPATIBILITY
  689.           XEDIT: N/A
  690.           KEDIT: Compatible.
  691.      
  692.      STATUS
  693.           Complete
  694.  
  695.  
  696.  
  697.      --------------------------------------------------------------------------
  698.      COMMAND
  699.           forward - scroll forwards a number of screens
  700.      
  701.      SYNTAX
  702.           FOrward [n]
  703.      
  704.      DESCRIPTION
  705.           The FORWARD command scrolls the file contents forwards the number
  706.           of screens specified.
  707.      
  708.      COMPATIBILITY
  709.           XEDIT: Compatible.
  710.           KEDIT: Does not support HALF or Lines options.
  711.      
  712.      DEFAULT
  713.           With no parameters, 1 screen is scrolled.
  714.      
  715.      SEE ALSO
  716.           backward,top
  717.      
  718.      STATUS
  719.           Complete
  720.  
  721.  
  722.  
  723.      --------------------------------------------------------------------------
  724.      COMMAND
  725.           get - read another file into current file
  726.      
  727.      SYNTAX
  728.           GET [fileid]
  729.      
  730.      DESCRIPTION
  731.           The GET command reads a file into the current file, inserting
  732.           lines after the current line.
  733.           When no fileid is supplied the temporary file is used.
  734.      
  735.      COMPATIBILITY
  736.           XEDIT: Does not support optional firstrec - numrecs
  737.           KEDIT: Does not support optional fromlines - forlines.
  738.      
  739.      SEE ALSO
  740.           put,putd
  741.      
  742.      STATUS
  743.           Complete
  744.  
  745.  
  746.  
  747.      --------------------------------------------------------------------------
  748.      COMMAND
  749.           help - display help for the editor
  750.      
  751.      SYNTAX
  752.           HELP
  753.      
  754.      DESCRIPTION
  755.           The HELP command displays help for the editor.
  756.           Uses THE_HELP environment variable to point to the help file.
  757.      
  758.      COMPATIBILITY
  759.           XEDIT: Similar in concept.
  760.           KEDIT: Similar in concept.
  761.      
  762.      STATUS
  763.           Complete.
  764.  
  765.  
  766.  
  767.      --------------------------------------------------------------------------
  768.      COMMAND
  769.           input - insert the command line contents into the file
  770.      
  771.      SYNTAX
  772.           Input [line contents]
  773.      
  774.      DESCRIPTION
  775.           The INPUT command inserts the remainder of the command line into the
  776.           file after the current line.
  777.      
  778.      COMPATIBILITY
  779.           XEDIT: Does not provide full input mode option.
  780.           KEDIT: Does not provide full input mode option.
  781.      
  782.      STATUS
  783.           Complete.
  784.  
  785.  
  786.  
  787.      --------------------------------------------------------------------------
  788.      COMMAND
  789.           join - join a line with the line following
  790.      
  791.      SYNTAX
  792.           Join [ALigned]
  793.      
  794.      DESCRIPTION
  795.           The JOIN command makes one line out of the focus line and the
  796.           line following.
  797.           If aligned is specified, any leading spaces in the following line
  798.           are ignored. If aligned is not specified, all characters, including
  799.           spaces are added.
  800.      
  801.      COMPATIBILITY
  802.           XEDIT: Compatible.
  803.           KEDIT: Compatible.
  804.      
  805.      STATUS
  806.           Complete.
  807.  
  808.  
  809.  
  810.      --------------------------------------------------------------------------
  811.      COMMAND
  812.           left_arrow - move the cursor left one column
  813.      
  814.      SYNTAX
  815.           ** effective only if bound to a key **
  816.      
  817.      DESCRIPTION
  818.           The left_arrow command moves the cursor left one column in the
  819.           current window. Scrolling of the main window horizontally, occurs
  820.           if the cursor is at the left-most column and the left-most column
  821.           is not the first column of the line.
  822.      
  823.      COMPATIBILITY
  824.           XEDIT: N/A
  825.           KEDIT: Equivalent of CURSOR LEFT
  826.      
  827.      SEE ALSO
  828.           Right_arrow
  829.      
  830.      STATUS
  831.           Complete.
  832.  
  833.  
  834.  
  835.      --------------------------------------------------------------------------
  836.      COMMAND
  837.           locate - make line identified by target become the current line
  838.      
  839.      SYNTAX
  840.           [Locate] target
  841.      
  842.      DESCRIPTION
  843.           The LOCATE command looks for the next or previous occurrence of the
  844.           specified target.  If no parameter is supplied, LOCATE
  845.           searches for the string that was used as the last string target, if
  846.           such a string target exists.
  847.      
  848.      COMPATIBILITY
  849.           XEDIT: Does not support [subcommand] option.
  850.           KEDIT: Compatible. (See bleow)
  851.           Does not support not,and,or combinations of string targets.
  852.           ie ~,& and | not supported.
  853.      
  854.      STATUS
  855.           Complete.
  856.  
  857.  
  858.  
  859.      --------------------------------------------------------------------------
  860.      COMMAND
  861.           lowercase - change uppercase characters to lowercase
  862.      
  863.      SYNTAX
  864.           LOWercase [target]
  865.      
  866.      DESCRIPTION
  867.           The LOWERCASE command changes all uppercase characters in the target
  868.           to lowercase. All other characters remain untouched.
  869.      
  870.      COMPATIBILITY
  871.           XEDIT: Equivalent of LOWERCAS command.
  872.           KEDIT: Compatible.
  873.      
  874.      STATUS
  875.           Complete.
  876.  
  877.  
  878.  
  879.      --------------------------------------------------------------------------
  880.      COMMAND
  881.           macro - execute a macro command file
  882.      
  883.      SYNTAX
  884.           MACRO filename [arguments]
  885.      
  886.      DESCRIPTION
  887.           The MACRO command executes the contents of the specified file
  888.           as command line commands.
  889.      
  890.      COMPATIBILITY
  891.           XEDIT: Compatible.
  892.           KEDIT: Compatible.
  893.           Only those systems that support REXX, support argument passing
  894.           to the macro file.
  895.      
  896.      STATUS
  897.           Complete.
  898.  
  899.  
  900.  
  901.      --------------------------------------------------------------------------
  902.      COMMAND
  903.           mark - mark a portion of text
  904.      
  905.      SYNTAX
  906.           MARK Line|Box|Stream
  907.      
  908.      DESCRIPTION
  909.           The MARK command marks a portion of text for later processing
  910.           by a COPY, MOVE or DELETE command.
  911.      
  912.      COMPATIBILITY
  913.           XEDIT: N/A
  914.           KEDIT: Does not implement Stream.
  915.      
  916.      STATUS
  917.           Complete...LINE and BOX options are anyway.
  918.  
  919.  
  920.  
  921.      --------------------------------------------------------------------------
  922.      COMMAND
  923.           modify - alter a setting
  924.      
  925.      SYNTAX
  926.           MODify set-command
  927.      
  928.      DESCRIPTION
  929.           The MODIFY command displays the current setting of a set command
  930.           on the command line to make changing that setting easy.
  931.      
  932.      COMPATIBILITY
  933.           XEDIT: Compatible.
  934.           KEDIT: Compatible.
  935.      
  936.      SEE ALSO
  937.           SET,QUERY
  938.      
  939.      STATUS
  940.           Complete.
  941.  
  942.  
  943.  
  944.      --------------------------------------------------------------------------
  945.      COMMAND
  946.           move - move a portion of text
  947.      
  948.      SYNTAX
  949.           MOVE target1 target2
  950.            or
  951.           MOVE BLOCK [RESET]
  952.      
  953.      DESCRIPTION
  954.           The MOVE command copies the contents of the marked block to the
  955.           current cursor position and deletes the characters/lines from the
  956.           original position of the marked block.
  957.      
  958.      COMPATIBILITY
  959.           The first form of the MOVE command has not yet been implemented.
  960.           XEDIT: Not implemented.
  961.           KEDIT: Adds extra functionality with [RESET] option.
  962.      
  963.      STATUS
  964.           Complete.
  965.  
  966.  
  967.  
  968.      --------------------------------------------------------------------------
  969.      COMMAND
  970.           msg - display message
  971.      
  972.      SYNTAX
  973.           MSG [message]
  974.      
  975.      DESCRIPTION
  976.           The MSG command displays an error message on the error line.
  977.           This command is usually issued from a macro file.
  978.           This is similar to EMSG, but MSG does not sound the bell if SET
  979.           BELL is on.
  980.      
  981.      COMPATIBILITY
  982.           XEDIT: Compatible.
  983.           KEDIT: Compatible.
  984.      
  985.      SEE ALSO
  986.           EMSG
  987.      
  988.      STATUS
  989.           Complete.
  990.  
  991.  
  992.  
  993.      --------------------------------------------------------------------------
  994.      COMMAND
  995.           next - move forward in the file a number of lines
  996.      
  997.      SYNTAX
  998.           Next [target]
  999.      
  1000.      DESCRIPTION
  1001.           The NEXT command moves the current_line forwards the number of
  1002.           lines specified by the target. Negative targets move backwards
  1003.           through the file.
  1004.      
  1005.      COMPATIBILITY
  1006.           XEDIT: Compatible.
  1007.           KEDIT: Compatible.
  1008.      
  1009.      SEE ALSO
  1010.           Up
  1011.      
  1012.      STATUS
  1013.           Complete.
  1014.  
  1015.  
  1016.  
  1017.      --------------------------------------------------------------------------
  1018.      COMMAND
  1019.           nextwindow - switch focus of editing session to other window
  1020.      
  1021.      SYNTAX
  1022.           NEXTWindow
  1023.      
  1024.      DESCRIPTION
  1025.           The NEXTWINDOW command moves the focus of the editing session to
  1026.           the other window (if more than one window is currently displayed)
  1027.           or to the next file in the ring.
  1028.      
  1029.      COMPATIBILITY
  1030.           XEDIT: N/A
  1031.           KEDIT: N/A
  1032.      
  1033.      SEE ALSO
  1034.           Edit,Screen
  1035.      
  1036.      STATUS
  1037.           Complete.
  1038.  
  1039.  
  1040.  
  1041.      --------------------------------------------------------------------------
  1042.      COMMAND
  1043.           nomsg - execute a command suppressing any messages 
  1044.      
  1045.      SYNTAX
  1046.           NOMSG command [parameters]
  1047.      
  1048.      DESCRIPTION
  1049.           The NOMSG command executes the supplied command but suppresses
  1050.           messages that may normally be displayed as a result of the command.
  1051.      
  1052.      COMPATIBILITY
  1053.           XEDIT: N/A
  1054.           KEDIT: Compatible.
  1055.      
  1056.      STATUS
  1057.           Complete.
  1058.  
  1059.  
  1060.  
  1061.      --------------------------------------------------------------------------
  1062.      COMMAND
  1063.           nop - no operation command
  1064.      
  1065.      SYNTAX
  1066.           NOP
  1067.      
  1068.      DESCRIPTION
  1069.           The NOP command doesn't do anything. It is used as a means of
  1070.           setting a key to do nothing.
  1071.      
  1072.      COMPATIBILITY
  1073.           XEDIT: N/A
  1074.           KEDIT: N/A
  1075.      
  1076.      SEE ALSO
  1077.           Define.
  1078.      
  1079.      STATUS
  1080.           Complete.
  1081.  
  1082.  
  1083.  
  1084.      --------------------------------------------------------------------------
  1085.      COMMAND
  1086.           os - execute an operating system command
  1087.      
  1088.      SYNTAX
  1089.           OS|DOS|! [command]
  1090.      
  1091.      DESCRIPTION
  1092.           The OS command executes the supplied os command or runs an
  1093.           interactive shell if no command is supplied.
  1094.      
  1095.      COMPATIBILITY
  1096.           XEDIT: N/A
  1097.           KEDIT: Equivalent of DOS command.
  1098.      
  1099.      STATUS
  1100.           Complete.
  1101.  
  1102.  
  1103.  
  1104.      --------------------------------------------------------------------------
  1105.      COMMAND
  1106.           osnowait - execute an operating system command - no wait
  1107.      
  1108.      SYNTAX
  1109.           OSNowait|DOSNowait command
  1110.      
  1111.      DESCRIPTION
  1112.           The OSNOWAIT command executes the supplied os command.
  1113.      
  1114.      COMPATIBILITY
  1115.           XEDIT: N/A
  1116.           KEDIT: Equivalent of DOSNOWAIT command.
  1117.      
  1118.      STATUS
  1119.           Complete.
  1120.  
  1121.  
  1122.  
  1123.      --------------------------------------------------------------------------
  1124.      COMMAND
  1125.           osquiet - execute an operating system command quietly
  1126.      
  1127.      SYNTAX
  1128.           OSQuiet|DOSQuiet command
  1129.      
  1130.      DESCRIPTION
  1131.           The OSQUIET command executes the supplied os command as quietly
  1132.           as possible.
  1133.      
  1134.      COMPATIBILITY
  1135.           XEDIT: N/A
  1136.           KEDIT: Equivalent of DOSQUIET command.
  1137.      
  1138.      STATUS
  1139.           Complete.
  1140.  
  1141.  
  1142.  
  1143.      --------------------------------------------------------------------------
  1144.      COMMAND
  1145.           overlaybox - overlay marked box block on current position
  1146.      
  1147.      SYNTAX
  1148.           OVERLAYBox
  1149.      
  1150.      DESCRIPTION
  1151.           The OVERLAYBOX copies the contents of the marked box block over the
  1152.           characters at the current cursor position or to column 1 of the
  1153.           current line if issued from the command line.
  1154.      
  1155.      COMPATIBILITY
  1156.           XEDIT: N/A
  1157.           KEDIT: Compatible.
  1158.      
  1159.      SEE ALSO
  1160.           move block, copy block
  1161.      
  1162.      STATUS
  1163.           Incomplete. Bug with overlaying text on top of itself.
  1164.  
  1165.  
  1166.  
  1167.      --------------------------------------------------------------------------
  1168.      COMMAND
  1169.           print - send text to default printer or print spooler
  1170.      
  1171.      SYNTAX
  1172.           PRint [target] [n]
  1173.           PRint LINE [text]
  1174.           PRint STRING [text]
  1175.           PRint FORMfeed
  1176.           PRint CLOSE
  1177.      
  1178.      DESCRIPTION
  1179.           The PRINT command writes a portion of the current file to the default
  1180.           printer or print spooler, or text entered on the command line.
  1181.        
  1182.           PRINT [target] [n]
  1183.              Sends text from the file contents up to the target to the printer
  1184.              followed by a CR/LF (DOS) or LF(UNIX) after each line.
  1185.              When [n] is specified, this sends a formfeed after [n] successive
  1186.              lines of text.
  1187.           PRINT LINE [text]
  1188.              Sends the remainder of the text on the command line to the printer
  1189.              followed by a CR/LF (DOS) or LF(UNIX).
  1190.           PRINT STRING [text]
  1191.              Sends the remainder of the text on the command line to the printer
  1192.              without any trailing line terminator.
  1193.           PRINT FORMFEED
  1194.               Sends a formfeed (^L) character to the printer.
  1195.           PRINT CLOSE
  1196.               Closes the printer spooler.
  1197.      
  1198.      COMPATIBILITY
  1199.           XEDIT: N/A
  1200.           KEDIT: Compatible.
  1201.      
  1202.      SEE ALSO
  1203.           printer
  1204.      
  1205.      STATUS
  1206.           Incomplete. OS/2 version does not work.
  1207.  
  1208.  
  1209.  
  1210.      --------------------------------------------------------------------------
  1211.      COMMAND
  1212.           put - write part of a file to another
  1213.      
  1214.      SYNTAX
  1215.           PUT [target] [fileid]
  1216.      
  1217.      DESCRIPTION
  1218.           The PUT command writes a portion of the current file to another
  1219.           file, either explicit or temporary.
  1220.           When no fileid is supplied the temporary file is overwritten.
  1221.           When a fileid is supplied the portion of the file written out
  1222.           is appended to the specified file.
  1223.      
  1224.      COMPATIBILITY
  1225.           XEDIT: Compatible.
  1226.           KEDIT: Compatible.
  1227.      
  1228.      SEE ALSO
  1229.           putd,get
  1230.      
  1231.      STATUS
  1232.           Complete.
  1233.  
  1234.  
  1235.  
  1236.      --------------------------------------------------------------------------
  1237.      COMMAND
  1238.           putd - write part of a file to another and delete
  1239.      
  1240.      SYNTAX
  1241.           PUTD [target] [fileid]
  1242.      
  1243.      DESCRIPTION
  1244.           The PUTD command writes a portion of the current file to another
  1245.           file, either explicit or temporary and deletes those lines written.
  1246.           When no fileid is supplied the temporary file is overwritten.
  1247.           When a fileid is supplied the portion of the file written out
  1248.           is appended to the specified file.
  1249.      
  1250.      COMPATIBILITY
  1251.           XEDIT: Compatible.
  1252.           KEDIT: Compatible.
  1253.      
  1254.      SEE ALSO
  1255.           put,get
  1256.      
  1257.      STATUS
  1258.           Complete.
  1259.  
  1260.  
  1261.  
  1262.      --------------------------------------------------------------------------
  1263.      COMMAND
  1264.           query - display various option settings
  1265.      
  1266.      SYNTAX
  1267.           Query item
  1268.      
  1269.      DESCRIPTION
  1270.           The QUERY command displays the various settings for options set
  1271.           by THE.
  1272.      
  1273.      COMPATIBILITY
  1274.           XEDIT: Compatible functionality, but not all options.
  1275.           KEDIT: Compatible functionality, but not all options.
  1276.      
  1277.      STATUS
  1278.           Complete.
  1279.  
  1280.  
  1281.  
  1282.      --------------------------------------------------------------------------
  1283.      COMMAND
  1284.           quit - exit from the current file
  1285.      
  1286.      SYNTAX
  1287.           QUIT
  1288.      
  1289.      DESCRIPTION
  1290.           The QUIT command exits the user from the current file, provided
  1291.           no changes have been made to the file. An error message will be
  1292.           displayed if changes have been made.
  1293.           The previous file in the ring then becomes the current file.
  1294.           If the current file is the only file in the ring, the user is
  1295.           returned to the Operating System.
  1296.      
  1297.      COMPATIBILITY
  1298.           XEDIT: Does not support return code option.
  1299.           KEDIT: Compatible.
  1300.      
  1301.      SEE ALSO
  1302.           qquit
  1303.      
  1304.      STATUS
  1305.           Complete
  1306.  
  1307.  
  1308.  
  1309.      --------------------------------------------------------------------------
  1310.      COMMAND
  1311.           qquit - exit from the current file
  1312.      
  1313.      SYNTAX
  1314.           QQuit
  1315.      
  1316.      DESCRIPTION
  1317.           The QQUIT command exits the user from the current file, whether
  1318.           changes have been made to the file or not.
  1319.           The previous file in the ring then becomes the current file.
  1320.           If the current file is the only file in the ring, the user is
  1321.           returned to the Operating System.
  1322.      
  1323.      COMPATIBILITY
  1324.           XEDIT: N/A
  1325.           KEDIT: Compatible.
  1326.      
  1327.      SEE ALSO
  1328.           quit
  1329.      
  1330.      STATUS
  1331.           Complete
  1332.  
  1333.  
  1334.  
  1335.      --------------------------------------------------------------------------
  1336.      COMMAND
  1337.           recover - recover changed or deleted lines
  1338.      
  1339.      SYNTAX
  1340.           RECover [n|*]
  1341.      
  1342.      DESCRIPTION
  1343.           The RECOVER command restores the last n changed or deleted lines
  1344.           back into the body of the file.
  1345.      
  1346.      COMPATIBILITY
  1347.           XEDIT: Also recovers changes to lines, not just lines deleted.
  1348.           KEDIT: Compatible.
  1349.      
  1350.      STATUS
  1351.           Complete.
  1352.  
  1353.  
  1354.  
  1355.      --------------------------------------------------------------------------
  1356.      COMMAND
  1357.           redraw - redraw the current screen
  1358.      
  1359.      SYNTAX
  1360.           REDRAW
  1361.      
  1362.      DESCRIPTION
  1363.           The REDRAW command redraws the current contents of the screen.
  1364.           This is usually used when some outside influence has stuffed the
  1365.           display up.
  1366.      
  1367.      COMPATIBILITY
  1368.           XEDIT: N/A
  1369.           KEDIT: N/A
  1370.      
  1371.      SEE ALSO
  1372.           REFRESH
  1373.      
  1374.      STATUS
  1375.           Complete.
  1376.  
  1377.  
  1378.  
  1379.      --------------------------------------------------------------------------
  1380.      COMMAND
  1381.           refresh - refresh the contents of the current screen
  1382.      
  1383.      SYNTAX
  1384.           REFRESH
  1385.      
  1386.      DESCRIPTION
  1387.           The REFRESH command refreshes what is being displayed on the screen.
  1388.           This is usually used from within a macro to indicate the progress
  1389.           of the macro.
  1390.      
  1391.      COMPATIBILITY
  1392.           XEDIT: Compatible.
  1393.           KEDIT: Compatible.
  1394.      
  1395.      STATUS
  1396.           Complete.
  1397.  
  1398.  
  1399.  
  1400.      --------------------------------------------------------------------------
  1401.      COMMAND
  1402.           replace - replace the current line with supplied text
  1403.      
  1404.      SYNTAX
  1405.           Replace [text]
  1406.      
  1407.      DESCRIPTION
  1408.           The REPLACE command replaces the current line with the supplied
  1409.           text.
  1410.      
  1411.      COMPATIBILITY
  1412.           XEDIT: Compatible.
  1413.           KEDIT: Compatible.
  1414.      
  1415.      STATUS
  1416.           Complete.
  1417.  
  1418.  
  1419.  
  1420.      --------------------------------------------------------------------------
  1421.      COMMAND
  1422.           reset - cancel the marked block or prefix commands or both
  1423.      
  1424.      SYNTAX
  1425.           RESet ALL|Block|Prefix
  1426.      
  1427.      DESCRIPTION
  1428.           The RESET command unmarks any marked block or outstanding prefix
  1429.           commands or both.
  1430.      
  1431.      COMPATIBILITY
  1432.           XEDIT: Adds Block and All options.
  1433.           KEDIT: Compatible.
  1434.      
  1435.      STATUS
  1436.           Complete.
  1437.  
  1438.  
  1439.  
  1440.      --------------------------------------------------------------------------
  1441.      COMMAND
  1442.           right_arrow - move the cursor to the right
  1443.      
  1444.      SYNTAX
  1445.           ** effective only if bound to a key **
  1446.      
  1447.      DESCRIPTION
  1448.           The right_arrow key causes the cursor to move one column to the
  1449.           right. If the cursor is on the right most column of the main
  1450.           window, the window will scroll half a window.
  1451.      
  1452.      COMPATIBILITY
  1453.           XEDIT: N/A
  1454.           KEDIT: Equivalent to CURSOR RIGHT.
  1455.      
  1456.      STATUS
  1457.           Complete
  1458.  
  1459.  
  1460.  
  1461.      --------------------------------------------------------------------------
  1462.      COMMAND
  1463.           save - save changes to current file
  1464.      
  1465.      SYNTAX
  1466.           SAVE [fileid]
  1467.      
  1468.      DESCRIPTION
  1469.           The save command writes the current file to disk. If a fileid is
  1470.           supplied, the current file is saved in that file, unless the file
  1471.           already exists when an error is displayed.
  1472.           The 'Alterations' counter on the heading line is reset to zero.
  1473.      
  1474.      COMPATIBILITY
  1475.           XEDIT: Compatible.
  1476.           KEDIT: Compatible.
  1477.      
  1478.      SEE ALSO
  1479.           ssave, file, ffile
  1480.      
  1481.      STATUS
  1482.           Complete
  1483.  
  1484.  
  1485.  
  1486.      --------------------------------------------------------------------------
  1487.      COMMAND
  1488.           schange - selectively change strings
  1489.      
  1490.      SYNTAX
  1491.           SCHange /string1/string2/ [target] [n] [m]
  1492.      
  1493.      DESCRIPTION
  1494.           The CHANGE command changes one string of text to another.
  1495.      
  1496.           The first parameter to the change command is the old and new
  1497.           string values, seperated by delimiters.
  1498.           The allowable delimiters are '/' '\' and '@'.
  1499.      
  1500.           The second parameter is the target; how many lines are to be
  1501.           searched for occurrences of the first string to be changed.
  1502.      
  1503.           The third parameter determines how many occurrences of 'string1'
  1504.           are to be changed on each line.
  1505.      
  1506.           The fourth parameter determines at which occurrences of 'string1'
  1507.           on the line are changes to commence.
  1508.      
  1509.      COMPATIBILITY
  1510.           XEDIT: Functionally compatible, but syntax different.
  1511.           KEDIT: Compatible.
  1512.      
  1513.      DEFAULT
  1514.           1 1 1
  1515.      
  1516.      SEE ALSO
  1517.           change
  1518.      
  1519.      STATUS
  1520.           Complete.
  1521.  
  1522.  
  1523.  
  1524.      --------------------------------------------------------------------------
  1525.      COMMAND
  1526.           set - execute various set commands
  1527.      
  1528.      SYNTAX
  1529.           SET set_command [set_command parameter(s) ...]
  1530.      
  1531.      DESCRIPTION
  1532.           The SET command is a front end to existing 'set' commands. It treats
  1533.           the first parameter it receives as a command and executes it.
  1534.      
  1535.      COMPATIBILITY
  1536.           XEDIT: Compatible.
  1537.           KEDIT: Compatible.
  1538.      
  1539.      STATUS
  1540.           Complete.
  1541.  
  1542.  
  1543.  
  1544.      --------------------------------------------------------------------------
  1545.      COMMAND
  1546.           shift - move text left or right
  1547.      
  1548.      SYNTAX
  1549.           SHift Left|Right [n] [target]
  1550.      
  1551.      DESCRIPTION
  1552.           The SHIFT command moves text in the direction specified the number
  1553.           of columns [n] for the specified target lines.
  1554.      
  1555.      COMPATIBILITY
  1556.           XEDIT: Compatible.
  1557.           KEDIT: Compatible.
  1558.      
  1559.      STATUS
  1560.           Complete.
  1561.  
  1562.  
  1563.  
  1564.      --------------------------------------------------------------------------
  1565.      COMMAND
  1566.           showkey - display current key value and command assignation
  1567.      
  1568.      SYNTAX
  1569.           SHOWKey 
  1570.      
  1571.      DESCRIPTION
  1572.           The SHOWKEY command prompts the user to enter a key and responds
  1573.           with the key name and associated command (if applicable).
  1574.      
  1575.      COMPATIBILITY
  1576.           XEDIT: N/A
  1577.           KEDIT: N/A
  1578.      
  1579.      STATUS
  1580.           Complete.
  1581.  
  1582.  
  1583.  
  1584.      --------------------------------------------------------------------------
  1585.      COMMAND
  1586.           sort - sort selected lines in a file
  1587.      
  1588.      SYNTAX
  1589.           SORT target [[[Ascending|Descending] left_col right_col] [...]]
  1590.      
  1591.      DESCRIPTION
  1592.           The SORT command sort a portion of a file based on the sort field
  1593.           specifications.
  1594.           target can be any valid target including ALL, *, -*, and BLOCK.
  1595.           Each sort field specification consists of an optional ordering
  1596.           flag and a left and right column.
  1597.      
  1598.           Only 10 sort fields are allowed.
  1599.      
  1600.      COMPATIBILITY
  1601.           XEDIT: XEDIT only allows ordering flag for all fields
  1602.           KEDIT: Compatible.
  1603.      
  1604.      BUGS
  1605.           Does not handle string targets with embedded blanks.
  1606.      
  1607.      STATUS
  1608.           Incomplete.
  1609.  
  1610.  
  1611.  
  1612.      --------------------------------------------------------------------------
  1613.      COMMAND
  1614.           sos - execute various sos commands
  1615.      
  1616.      SYNTAX
  1617.           SOS sos_command [sos_command ...]
  1618.      
  1619.      DESCRIPTION
  1620.           The SOS command is a front end to existing 'sos' commands. It treats
  1621.           each parameter it receives as a command and executes it.
  1622.      
  1623.      COMPATIBILITY
  1624.           XEDIT: XEDIT only permits 1 command
  1625.           KEDIT: Compatible.
  1626.      
  1627.      STATUS
  1628.           Complete.
  1629.  
  1630.  
  1631.  
  1632.      --------------------------------------------------------------------------
  1633.      COMMAND
  1634.           split - split a line
  1635.      
  1636.      SYNTAX
  1637.           SPlit [ALigned]
  1638.      
  1639.      DESCRIPTION
  1640.           The SPLIT command splits the focus line into two lines.
  1641.           If aligned is specified, the first non-blank character of the new
  1642.           line is positioned under the first non-blank character of the
  1643.           focus line. If aligned is not specified, the text of the new line
  1644.           starts in column 1.
  1645.      
  1646.      COMPATIBILITY
  1647.           XEDIT: Compatible.
  1648.           KEDIT: Compatible.
  1649.      
  1650.      STATUS
  1651.           Complete.
  1652.  
  1653.  
  1654.  
  1655.      --------------------------------------------------------------------------
  1656.      COMMAND
  1657.           spltjoin - split/join two lines
  1658.      
  1659.      SYNTAX
  1660.           ** effective only if bound to a key **
  1661.      
  1662.      DESCRIPTION
  1663.           The SPLTJOIN command splits the focus line into two or joins the
  1664.           focus line with the next line depending on the position of the
  1665.           cursor. If the cursor is after the last column of a line, a 'join'
  1666.           is executed, otherwise a 'split' is executed.
  1667.           The text in the new line is aligned with the text in the focus line.
  1668.      
  1669.      COMPATIBILITY
  1670.           XEDIT: Compatible.
  1671.           KEDIT: Compatible.
  1672.      
  1673.      STATUS
  1674.           Complete.
  1675.  
  1676.  
  1677.  
  1678.      --------------------------------------------------------------------------
  1679.      COMMAND
  1680.           ssave - save changes to current file
  1681.      
  1682.      SYNTAX
  1683.           SSave [fileid]
  1684.      
  1685.      DESCRIPTION
  1686.           The ssave command writes the current file to disk. If a fileid is
  1687.           supplied, the current file is saved in that file, otherwise the
  1688.           current name of the file is used.
  1689.           If a fileid is supplied and that fileid already exists, the previous
  1690.           contents of that fileid will be replaced with the current file.
  1691.           The 'Alterations' counter on the heading line is reset to zero.
  1692.      
  1693.      COMPATIBILITY
  1694.           XEDIT: N/A
  1695.           KEDIT: Compatible.
  1696.      
  1697.      SEE ALSO
  1698.           save, file, ffile
  1699.      
  1700.      STATUS
  1701.           Complete
  1702.  
  1703.  
  1704.  
  1705.      --------------------------------------------------------------------------
  1706.      COMMAND
  1707.           status - display current settings of various variables
  1708.      
  1709.      SYNTAX
  1710.           STATus [filename]
  1711.      
  1712.      DESCRIPTION
  1713.           The STATUS command, without the optional filename, displays a full
  1714.           screen of current settings for various variables. With the filename,
  1715.           the STATUS command creates a file containing a series of SET commands
  1716.           with the current values of these settings.
  1717.      
  1718.      COMPATIBILITY
  1719.           XEDIT: Compatible.
  1720.           KEDIT: Compatible. KEDIT does not support [filename] option.
  1721.      
  1722.      SEE ALSO
  1723.           QUERY, EXTRACT, MODIFY
  1724.      
  1725.      STATUS
  1726.           Complete
  1727.  
  1728.  
  1729.  
  1730.      --------------------------------------------------------------------------
  1731.      COMMAND
  1732.           suspend - suspend THE and return to operating system
  1733.      
  1734.      SYNTAX
  1735.           SUSPend
  1736.      
  1737.      DESCRIPTION
  1738.           The SUSPEND command suspends the current editing session and 
  1739.           returns control to the operating system. Under DOS and OS/2 this
  1740.           is the equivalent of OSNowait. Under UNIX, the process gets placed
  1741.           in the background until it is brought to the foreground.
  1742.      
  1743.      COMPATIBILITY
  1744.           XEDIT: N/A
  1745.           KEDIT: N/A
  1746.      
  1747.      SEE ALSO
  1748.           OSQUIET
  1749.      
  1750.      STATUS
  1751.           Complete
  1752.  
  1753.  
  1754.  
  1755.      --------------------------------------------------------------------------
  1756.      COMMAND
  1757.           tabcmd - switch windows (main/prefix command) for the current file
  1758.      
  1759.      SYNTAX
  1760.           TABCmd
  1761.           ** effective only if bound to a key **
  1762.      
  1763.      DESCRIPTION
  1764.           The TABCMD command switches the focus of the editor from the
  1765.           main or prefix windows to the command line and vice versa, depending
  1766.           on which window is currently active.
  1767.      
  1768.      COMPATIBILITY
  1769.           XEDIT: Equivalent of CURSOR HOME.
  1770.           KEDIT: Equivalent of CURSOR HOME.
  1771.      
  1772.      SEE ALSO
  1773.           tabpre
  1774.      
  1775.      STATUS
  1776.           Complete. Will be replaced by CURSOR HOME in the future.
  1777.  
  1778.  
  1779.  
  1780.      --------------------------------------------------------------------------
  1781.      COMMAND
  1782.           tabpre - switch windows (main/prefix) for the current file
  1783.      
  1784.      SYNTAX
  1785.           TABPre
  1786.           ** effective only if bound to a key **
  1787.      
  1788.      DESCRIPTION
  1789.           The TABPRE command switches the focus of the editor from the
  1790.           main window to the prefix window and vice versa, depending
  1791.           on which window is currently active.
  1792.      
  1793.      COMPATIBILITY
  1794.           XEDIT: N/A
  1795.           KEDIT: Equivalent of SOS LEFTEDGE and SOS PREFIX
  1796.      
  1797.      SEE ALSO
  1798.           tabcmd
  1799.      
  1800.      STATUS
  1801.           Complete.
  1802.  
  1803.  
  1804.  
  1805.      --------------------------------------------------------------------------
  1806.      COMMAND
  1807.           text - simulate keyboard entry of characters
  1808.      
  1809.      SYNTAX
  1810.           TEXT text
  1811.      
  1812.      DESCRIPTION
  1813.           The TEXT command simulates the entry of characters from the
  1814.           keyboard. This command is actually called when you enter text
  1815.           from the keyboard.
  1816.      
  1817.      COMPATIBILITY
  1818.           XEDIT: N/A
  1819.           KEDIT: Compatible.
  1820.                  Does not allow leading or trailing spaces in text (at the
  1821.                  moment)
  1822.      
  1823.      STATUS
  1824.           Complete.
  1825.  
  1826.  
  1827.  
  1828.      --------------------------------------------------------------------------
  1829.      COMMAND
  1830.           top - move to the top of the file
  1831.      
  1832.      SYNTAX
  1833.           TOP
  1834.      
  1835.      DESCRIPTION
  1836.           The TOP command moves to the very start of the current file.
  1837.           The "Top-of-file" line is set to the current_line.
  1838.      
  1839.           "TOP" is equivalent to "BACKWARD *".
  1840.      
  1841.      COMPATIBILITY
  1842.           XEDIT: Compatible.
  1843.           KEDIT: Compatible.
  1844.      
  1845.      SEE ALSO
  1846.           backward,bottom
  1847.      
  1848.      STATUS
  1849.           Complete
  1850.  
  1851.  
  1852.  
  1853.      --------------------------------------------------------------------------
  1854.      COMMAND
  1855.           up - move backward in the file a number of lines
  1856.      
  1857.      SYNTAX
  1858.           Up [n|*]
  1859.      
  1860.      DESCRIPTION
  1861.           The UP command moves the current_line backwards the number of
  1862.           lines specified by 'n'. Negative values of 'n' move forwards
  1863.           through the file.
  1864.      
  1865.      COMPATIBILITY
  1866.           XEDIT: Compatible.
  1867.           KEDIT: Compatible.
  1868.      
  1869.      SEE ALSO
  1870.           Next
  1871.      
  1872.      STATUS
  1873.           Complete.
  1874.  
  1875.  
  1876.  
  1877.      --------------------------------------------------------------------------
  1878.      COMMAND
  1879.           up_arrow - move the cursor up one line
  1880.      
  1881.      SYNTAX
  1882.           ** effective only if bound to a key **
  1883.      
  1884.      DESCRIPTION
  1885.           The up_arrow command moves the cursor up one line in the main
  1886.           window. Scrolling of the window occurs if the cursor is on the first
  1887.           line of the window.
  1888.      
  1889.           When on the command line, this command moves backward through the
  1890.           list of previous command line commands or tabs to the last line of
  1891.           the main window depending on the value set by the function
  1892.           cmdarrows. (default is the former)
  1893.      
  1894.      COMPATIBILITY
  1895.           XEDIT: N/A
  1896.           KEDIT: Equivalent of CURSOR UP
  1897.      
  1898.      SEE ALSO
  1899.           Down_arrow
  1900.      
  1901.      STATUS
  1902.           Complete.
  1903.  
  1904.  
  1905.  
  1906.      --------------------------------------------------------------------------
  1907.      COMMAND
  1908.           uppercase - change lowercase characters to uppercase
  1909.      
  1910.      SYNTAX
  1911.           UPPercase [target]
  1912.      
  1913.      DESCRIPTION
  1914.           The UPPERCASE command changes all lowercase characters in the target
  1915.           to uppercase. All other characters remain untouched.
  1916.      
  1917.      COMPATIBILITY
  1918.           XEDIT: Equivalent of UPPERCAS
  1919.           KEDIT: Compatible.
  1920.      
  1921.      SEE ALSO
  1922.           lowercase
  1923.      
  1924.      STATUS
  1925.           Complete.
  1926.  
  1927.  
  1928.  
  1929.      --------------------------------------------------------------------------
  1930.      COMMAND
  1931.           xedit - edit another file
  1932.      
  1933.      SYNTAX
  1934.           Xedit [filename]
  1935.           THE   [filename]
  1936.           Edit  [filename]
  1937.      
  1938.      DESCRIPTION
  1939.           The EDIT command allows the user to edit another file. The new file
  1940.           is placed in the file ring. The previous file being edited remains
  1941.           in memory and can be returned to by issuing an EDIT command without
  1942.           any parameters. Several files can be edited at once, and all files
  1943.           are arranged in a ring, with subsequent EDIT commands moving through
  1944.           the ring, one file at a time.
  1945.      
  1946.      COMPATIBILITY
  1947.           XEDIT: Does not provide options switches.
  1948.           KEDIT: Does not provide options switches.
  1949.      
  1950.      STATUS
  1951.           Complete.
  1952.  
  1953.  
  1954.  
  1955.      --------------------------------------------------------------------------
  1956.      COMMAND
  1957.           retrieve - return the next/prior command
  1958.      
  1959.      SYNTAX
  1960.           ?[+]
  1961.      
  1962.      DESCRIPTION
  1963.           The ? command returns the next or prior command from the command
  1964.           line stack and displays it on the command line.
  1965.           With no parameters, the most recent command entered on the command
  1966.           line is retrieved.
  1967.      
  1968.      COMPATIBILITY
  1969.           XEDIT: Compatible.
  1970.           KEDIT: See below..
  1971.           Does not support multiple '?' as in ??? to retrieve the third last
  1972.           command.
  1973.           This command is bound to the up and down arrows when on the
  1974.           command line depending on the setting of CMDARROWS.
  1975.      
  1976.      SEE ALSO
  1977.           cmdarrows
  1978.      
  1979.      STATUS
  1980.           Complete.
  1981.  
  1982.  
  1983.  
  1984.      --------------------------------------------------------------------------
  1985.      COMMAND
  1986.           = re-execute the last command issued on the command line
  1987.      
  1988.      SYNTAX
  1989.           =
  1990.      
  1991.      DESCRIPTION
  1992.           The = command retrieves the most recently issued command from
  1993.           the command line and re-executes it.
  1994.      
  1995.      COMPATIBILITY
  1996.           XEDIT: Does not support optional [subcommand] option.
  1997.           KEDIT: Does not support optional [command] option.
  1998.      
  1999.      STATUS
  2000.           Complete.
  2001.  
  2002.  
  2003.  
  2004.      --------------------------------------------------------------------------
  2005.      
  2006.      
  2007.      
  2008.      ========================================================================
  2009.      SOS COMMAND REFERENCE
  2010.      ========================================================================
  2011.  
  2012.  
  2013.  
  2014.      --------------------------------------------------------------------------
  2015.      COMMAND
  2016.           SOS ADDline - add blank line after focus line
  2017.           SOS LINEAdd - add blank line after focus line
  2018.      
  2019.      SYNTAX
  2020.           ** effective only if bound to a key **
  2021.      
  2022.      DESCRIPTION
  2023.           The SOS ADDLINE command inserts a blank line in the file following
  2024.           the focus line. The cursor is placed in the column under the first
  2025.           non-blank in the focus line.
  2026.      
  2027.      COMPATIBILITY
  2028.           XEDIT: Compatible.
  2029.           KEDIT: Compatible.
  2030.      
  2031.      SEE ALSO
  2032.           SOS DELLINE
  2033.      
  2034.      STATUS
  2035.           Complete
  2036.  
  2037.  
  2038.  
  2039.      --------------------------------------------------------------------------
  2040.      COMMAND
  2041.           SOS CURSORAdj - move first non-blank character to cursor
  2042.      
  2043.      SYNTAX
  2044.           ** effective only if bound to a key **
  2045.      
  2046.      DESCRIPTION
  2047.           The SOS CURSORADJ command moves text in the focus line so that
  2048.           the first non-blank character appears under the cursor position.
  2049.      
  2050.      COMPATIBILITY
  2051.           XEDIT: N/A
  2052.           KEDIT: Compatible.
  2053.      
  2054.      STATUS
  2055.           Complete
  2056.  
  2057.  
  2058.  
  2059.      --------------------------------------------------------------------------
  2060.      COMMAND
  2061.           SOS DELBAck - delete the character to the left of the cursor
  2062.      
  2063.      SYNTAX
  2064.           ** effective only if bound to a key **
  2065.      
  2066.      DESCRIPTION
  2067.           The SOS DELBACK command moves the cursor one character to the left
  2068.           and deletes the character now under the cursor.
  2069.      
  2070.      COMPATIBILITY
  2071.           XEDIT: N/A
  2072.           KEDIT: Compatible.
  2073.      
  2074.      SEE ALSO
  2075.           SOS DELCHAR
  2076.      
  2077.      STATUS
  2078.           Complete
  2079.  
  2080.  
  2081.  
  2082.      --------------------------------------------------------------------------
  2083.      COMMAND
  2084.           SOS DELChar - delete character under cursor
  2085.      
  2086.      SYNTAX
  2087.           ** effective only if bound to a key **
  2088.      
  2089.      DESCRIPTION
  2090.           The SOS DELCHAR command deletes the character under the cursor.
  2091.           Text to the right is shifted to the left.
  2092.      
  2093.      COMPATIBILITY
  2094.           XEDIT: N/A
  2095.           KEDIT: Compatible.
  2096.      
  2097.      STATUS
  2098.           Complete
  2099.  
  2100.  
  2101.  
  2102.      --------------------------------------------------------------------------
  2103.      COMMAND
  2104.           SOS DELEnd - delete to end of line
  2105.      
  2106.      SYNTAX
  2107.           ** effective only if bound to a key **
  2108.      
  2109.      DESCRIPTION
  2110.           The SOS DELEND command deletes all characters from the current
  2111.           column to the end of line.
  2112.      
  2113.      COMPATIBILITY
  2114.           XEDIT: N/A
  2115.           KEDIT: Compatible.
  2116.      
  2117.      STATUS
  2118.           Complete.
  2119.  
  2120.  
  2121.  
  2122.      --------------------------------------------------------------------------
  2123.      COMMAND
  2124.           SOS DELLine - delete focus line
  2125.           SOS LINEDel - delete focus line
  2126.      
  2127.      SYNTAX
  2128.           ** effective only if bound to a key **
  2129.      
  2130.      DESCRIPTION
  2131.           The SOS DELLINE command deletes the focus line.
  2132.      
  2133.      COMPATIBILITY
  2134.           XEDIT: Compatible.
  2135.           KEDIT: Compatible.
  2136.      
  2137.      SEE ALSO
  2138.           SOS ADDLINE
  2139.      
  2140.      STATUS
  2141.           Complete
  2142.  
  2143.  
  2144.  
  2145.      --------------------------------------------------------------------------
  2146.      COMMAND
  2147.           SOS DELWord - delete word at or right of cursor
  2148.      
  2149.      SYNTAX
  2150.           ** effective only if bound to a key **
  2151.      
  2152.      DESCRIPTION
  2153.           The SOS DELWORD command deletes the word at or to the right
  2154.           of the current cursor position.
  2155.      
  2156.      COMPATIBILITY
  2157.           XEDIT: N/A
  2158.           KEDIT: Compatible.
  2159.      
  2160.      STATUS
  2161.           Complete
  2162.  
  2163.  
  2164.  
  2165.      --------------------------------------------------------------------------
  2166.      COMMAND
  2167.           SOS DOPREfix - execute any pending prefix commands
  2168.      
  2169.      SYNTAX
  2170.           ** effective only if bound to a key **
  2171.      
  2172.      DESCRIPTION
  2173.           The SOS DOPREFIX command executes any pending prefix commands.
  2174.      
  2175.      COMPATIBILITY
  2176.           XEDIT: N/A
  2177.           KEDIT: Compatible.
  2178.      
  2179.      STATUS
  2180.           Complete
  2181.  
  2182.  
  2183.  
  2184.      --------------------------------------------------------------------------
  2185.      COMMAND
  2186.           SOS EDIT - edit a file from directory list
  2187.      
  2188.      SYNTAX
  2189.           ** effective only if bound to a key **
  2190.      
  2191.      DESCRIPTION
  2192.           The SOS EDIT command allows the user to edit a file, chosen from
  2193.           a directory list.(the file DIR.DIR).
  2194.      
  2195.      COMPATIBILITY
  2196.           XEDIT: N/A
  2197.           KEDIT: Compatible with default definition for Alt-X key.
  2198.      
  2199.      STATUS
  2200.           Complete.
  2201.  
  2202.  
  2203.  
  2204.      --------------------------------------------------------------------------
  2205.      COMMAND
  2206.           SOS ENDChar - move cursor to end/start of focus line
  2207.      
  2208.      SYNTAX
  2209.           ** effective only if bound to a key **
  2210.      
  2211.      DESCRIPTION
  2212.           The SOS ENDCHAR command moves the cursor to the first character
  2213.           displayed in the current window, if the cursor is after the last
  2214.           character displayed in the current window, or to the position after
  2215.           the last character displayed in the current window, if the cursor is
  2216.           anywhere else.
  2217.      
  2218.      COMPATIBILITY
  2219.           XEDIT: N/A
  2220.           KEDIT: Compatible. See below.
  2221.           The possible combinations of VERIFY etc. make mimicing KEDIT very
  2222.           difficult. The command is, on the surface, compatible.
  2223.      
  2224.      STATUS
  2225.           incomplete-problem determining exactly where the cursor should go
  2226.           when a verify end is in place and we are going to the end of line
  2227.  
  2228.  
  2229.  
  2230.      --------------------------------------------------------------------------
  2231.      COMMAND
  2232.           SOS EXecute - move cursor to command line and execute command
  2233.      
  2234.      SYNTAX
  2235.           ** effective only if bound to a key **
  2236.      
  2237.      DESCRIPTION
  2238.           The SOS EXECUTE command moves the cursor to the command line
  2239.           and executes any command that is on the command line.
  2240.      
  2241.      COMPATIBILITY
  2242.           XEDIT: N/A
  2243.           KEDIT: Compatible
  2244.      
  2245.      STATUS
  2246.           Complete...but because of potential infinite recursion, this function
  2247.           has been suspended.
  2248.  
  2249.  
  2250.  
  2251.      --------------------------------------------------------------------------
  2252.      COMMAND
  2253.           SOS MAKECURR - make focus line the current line
  2254.      
  2255.      SYNTAX
  2256.           ** effective only if bound to a key **
  2257.      
  2258.      DESCRIPTION
  2259.           The SOS MAKECURR command set the current line to the current focus
  2260.           line.
  2261.      
  2262.      COMPATIBILITY
  2263.           XEDIT: N/A
  2264.           KEDIT: Compatible.
  2265.      
  2266.      SEE ALSO
  2267.      
  2268.      STATUS
  2269.           Complete
  2270.  
  2271.  
  2272.  
  2273.      --------------------------------------------------------------------------
  2274.      COMMAND
  2275.           SOS TABf - move cursor to next tab stop
  2276.      
  2277.      SYNTAX
  2278.           ** effective only if bound to a key **
  2279.      
  2280.      DESCRIPTION
  2281.           The SOS TABF command causes the cursor to move to the next tab column
  2282.           as set by the TABS command. (The default is 8).
  2283.           If the resulting column is beyond the right hand edge of the main
  2284.           window, the window will scroll half a window.
  2285.      
  2286.      COMPATIBILITY
  2287.           XEDIT: Does not allow arguments.
  2288.           KEDIT: Compatible. See below.
  2289.           Does not line tab to next line if after the right hand tab column.
  2290.      
  2291.      SEE ALSO
  2292.           tabs
  2293.      
  2294.      STATUS
  2295.           Complete.
  2296.  
  2297.  
  2298.  
  2299.      --------------------------------------------------------------------------
  2300.      COMMAND
  2301.           SOS TABWORDB - move cursor to beginning of previous word
  2302.      
  2303.      SYNTAX
  2304.           ** effective only if bound to a key **
  2305.      
  2306.      DESCRIPTION
  2307.           The SOS TABWORDB command causes the cursor to move to the first character
  2308.           of the word to the left or to the start of the line if no more
  2309.           words precede.
  2310.           If the resulting column is beyond the left hand edge of the main
  2311.           window, the window will scroll half a window.
  2312.      
  2313.      COMPATIBILITY
  2314.           XEDIT: N/A
  2315.           KEDIT: Compatible.
  2316.      
  2317.      SEE ALSO
  2318.           SOS TABWORDF
  2319.      
  2320.      STATUS
  2321.           Complete.
  2322.  
  2323.  
  2324.  
  2325.      --------------------------------------------------------------------------
  2326.      COMMAND
  2327.           SOS TABWORDf - move cursor to start of next word
  2328.      
  2329.      SYNTAX
  2330.           ** effective only if bound to a key **
  2331.      
  2332.      DESCRIPTION
  2333.           The SOS TABWORDF command causes the cursor to move to the first character
  2334.           of the next word to the right or to the end of the line if no more
  2335.           words follow.
  2336.           If the resulting column is beyond the right hand edge of the main
  2337.           window, the window will scroll half a window.
  2338.      
  2339.      COMPATIBILITY
  2340.           XEDIT: N/A
  2341.           KEDIT: Compatible.
  2342.      
  2343.      SEE ALSO
  2344.           SOS TABWORDB
  2345.      
  2346.      STATUS
  2347.           Complete.
  2348.  
  2349.  
  2350.  
  2351.      --------------------------------------------------------------------------
  2352.      COMMAND
  2353.           SOS UNDO - undo changes to the current line
  2354.      
  2355.      SYNTAX
  2356.           ** effective only if bound to a key **
  2357.      
  2358.      DESCRIPTION
  2359.           The SOS UNDO command causes the contents of the focus line (or the
  2360.           command line) to be reset to the contents before the cursor was
  2361.           positioned there.
  2362.      
  2363.      COMPATIBILITY
  2364.           XEDIT: N/A
  2365.           KEDIT: Compatible. See below.
  2366.           Basically compatible. Doesn't restore the cursor to the original
  2367.           column position.
  2368.      
  2369.      STATUS
  2370.           Complete.
  2371.  
  2372.  
  2373.  
  2374.      --------------------------------------------------------------------------
  2375.      
  2376.      
  2377.      
  2378.      ========================================================================
  2379.      SET COMMAND REFERENCE
  2380.      ========================================================================
  2381.  
  2382.  
  2383.  
  2384.      --------------------------------------------------------------------------
  2385.      COMMAND
  2386.           arbchar - set arbitrary character for change commands
  2387.      
  2388.      SYNTAX
  2389.           [SET] ARBchar ON|OFF [char]
  2390.      
  2391.      DESCRIPTION
  2392.           Set the character to use as an 'arbitrary character' when using
  2393.           change commands. When on the character specified no longer matches
  2394.           itself in locating a character to change but matches all characters.
  2395.      
  2396.      COMPATIBILITY
  2397.           XEDIT: See below
  2398.           KEDIT: See below
  2399.           Only allows for single character matching, not multiple strings.
  2400.      
  2401.      DEFAULT
  2402.           OFF ?
  2403.      
  2404.      SEE ALSO
  2405.           Change,Schange and Locate
  2406.      
  2407.      STATUS
  2408.           Complete.
  2409.  
  2410.  
  2411.  
  2412.      --------------------------------------------------------------------------
  2413.      COMMAND
  2414.           autosave - set autosave period
  2415.      
  2416.      SYNTAX
  2417.           [SET] AUtosave n|OFF
  2418.      
  2419.      DESCRIPTION
  2420.           The AUTOSAVE command sets the interval between automatic saves
  2421.           of the file, or turns it off altogether.
  2422.      
  2423.      COMPATIBILITY
  2424.           XEDIT: Does not support [mode] option.
  2425.           KEDIT: Compatible.
  2426.      
  2427.      STATUS
  2428.           Complete.
  2429.  
  2430.  
  2431.  
  2432.      --------------------------------------------------------------------------
  2433.      COMMAND
  2434.           backup - indicate if a backup copy of the file is to be kept
  2435.      
  2436.      SYNTAX
  2437.           [SET] BACKup ON|OFF
  2438.      
  2439.      DESCRIPTION
  2440.           The BACKUP command allows the user to determine if a backup copy
  2441.           of the original file is to be kept when the file being edited is
  2442.           saved or filed.
  2443.      
  2444.      COMPATIBILITY
  2445.           XEDIT: N/A
  2446.           KEDIT: Does not support TEMP or KEEP options.
  2447.      
  2448.      DEFAULT
  2449.           ON - a backup file is kept
  2450.      
  2451.      SEE ALSO
  2452.           file,ffile,save,ssave
  2453.      
  2454.      STATUS
  2455.           Complete.
  2456.  
  2457.  
  2458.  
  2459.      --------------------------------------------------------------------------
  2460.      COMMAND
  2461.           beep - turn on or off the audible alarm when displaying errors
  2462.      
  2463.      SYNTAX
  2464.           [SET] BEEP ON|OFF
  2465.      
  2466.      DESCRIPTION
  2467.           The BEEP command allows the user to determine if an audible alarm
  2468.           is sounded when an error is displayed.
  2469.      
  2470.      COMPATIBILITY
  2471.           XEDIT: N/A
  2472.           KEDIT: Compatible.
  2473.      
  2474.      DEFAULT
  2475.           OFF
  2476.      
  2477.      STATUS
  2478.           Complete.
  2479.  
  2480.  
  2481.  
  2482.      --------------------------------------------------------------------------
  2483.      COMMAND
  2484.           case - set case sensitivity parameters
  2485.      
  2486.      SYNTAX
  2487.           [SET] CASE Mixed|Lower|Upper [Respect|Ignore] [Respect|Ignore]
  2488.                                        [Respect|Ignore]
  2489.      
  2490.      DESCRIPTION
  2491.           The CASE command sets the editor's handling of the case of text.
  2492.      
  2493.           The first option (which is mandatory) controls how text is entered
  2494.           by the user. When LOWER or UPPER are in effect, the shift or caps
  2495.           lock keys have no effect on the text being entered. When MIXED is
  2496.           in effect, text is entered in the case set by the use of the shift
  2497.           and caps lock keys.
  2498.      
  2499.           The second option determines how the editor determines if a string
  2500.           target matches text in the file when the target is used in a LOCATE
  2501.           command.  With IGNORE in effect, a match is
  2502.           found irrespective of the case of the target or the found text.
  2503.           The following strings are treated as equivalent: the THE The ThE...
  2504.           With RESPECT in effect, the target and text must be the same case.
  2505.           Therefore a target of 'The' only matches text containing 'The', not
  2506.           'THE' or 'ThE' etc.
  2507.      
  2508.           The third option determines how the editor determines if a string
  2509.           target matches text in the file when the target is used in a CHANGE
  2510.           command.  With IGNORE in effect, a match is
  2511.           found irrespective of the case of the target or the found text.
  2512.           The following strings are treated as equivalent: the THE The ThE...
  2513.           With RESPECT in effect, the target and text must be the same case.
  2514.           Therefore a target of 'The' only matches text containing 'The', not
  2515.           'THE' or 'ThE' etc.
  2516.      
  2517.           The fourth option determines how the editor determines the sort 
  2518.           order of upper and lower case with the SORT command.
  2519.           With IGNORE in effect, upper and lower case letters are treated as
  2520.           equivalent.
  2521.           With RESPECT in effect, upper and lower case letters are treated as
  2522.           different values and uppercase characters will sort before lowercase
  2523.           characters.
  2524.      
  2525.      COMPATIBILITY
  2526.           XEDIT: Adds support for case significance in CHANGE commands.
  2527.           KEDIT: Adds support for LOWER option.
  2528.           Both:  Adds support for case significance in SORT command.
  2529.      
  2530.      DEFAULT
  2531.           MIXED IGNORE RESPECT RESPECT
  2532.      
  2533.      STATUS
  2534.           Complete
  2535.  
  2536.  
  2537.  
  2538.      --------------------------------------------------------------------------
  2539.      COMMAND
  2540.           clearscreen - indicate if the screen is to be cleared on exit
  2541.      
  2542.      SYNTAX
  2543.           [SET] CLEARScreen ON|OFF
  2544.      
  2545.      DESCRIPTION
  2546.           The CLEARSCREEN command allows the user to request that the screen be
  2547.           cleared on exit from THE.
  2548.      
  2549.      COMPATIBILITY
  2550.           XEDIT: N/A
  2551.           KEDIT: N/A
  2552.      
  2553.      DEFAULT
  2554.           OFF - a clear screen does not occur.
  2555.      
  2556.      STATUS
  2557.           Complete
  2558.  
  2559.  
  2560.  
  2561.      --------------------------------------------------------------------------
  2562.      COMMAND
  2563.           clock - turn on or display of time on status line
  2564.      
  2565.      SYNTAX
  2566.           [SET] CLOCK ON|OFF
  2567.      
  2568.      DESCRIPTION
  2569.           The CLOCK command turns on or off the display of the time on the
  2570.           status line.
  2571.      
  2572.      COMPATIBILITY
  2573.           XEDIT: N/A
  2574.           KEDIT: Compatible.
  2575.      
  2576.      DEFAULT
  2577.           ON - the time is displayed.
  2578.      
  2579.      STATUS
  2580.           Complete
  2581.  
  2582.  
  2583.  
  2584.      --------------------------------------------------------------------------
  2585.      COMMAND
  2586.           cmdarrows - sets the functionality of the arrows keys
  2587.      
  2588.      SYNTAX
  2589.           [SET] CMDArrows Retrieve|Tab Scroll|Tab Scroll|Tab
  2590.      
  2591.      DESCRIPTION
  2592.           The CMDARROWS command determines the action that occurs when the
  2593.           arrows keys are hit.
  2594.      
  2595.           CMDARROWS RETRIEVE SCROLL SCROLL (the default) will set the up and 
  2596.           down arrows to retrieve the last or next command entered on the command 
  2597.           line and to scroll the screen when at the top or bottom of the main
  2598.           text window. The left and right arrows will cause the main text window 
  2599.           to scroll if appropriate.
  2600.      
  2601.           CMDARROWS TAB TAB TAB will set the up and down arrows to move to the
  2602.           last or first line respectively of the main window and to return to 
  2603.           the command line when the top or bottom of the main text window is 
  2604.           reached. The left and right arrows will wrap around the window if on
  2605.           the command line or no prefix is on or to move between the prefix area.
  2606.           This behaviour is more like XEDIT.
  2607.      
  2608.      DEFAULT
  2609.           RETRIEVE SCROLL SCROLL
  2610.      
  2611.      COMPATIBILITY
  2612.           XEDIT: N/A
  2613.           KEDIT: N/A
  2614.      
  2615.      STATUS
  2616.           Complete.
  2617.  
  2618.  
  2619.  
  2620.      --------------------------------------------------------------------------
  2621.      COMMAND
  2622.           cmdline - sets the position of the command line.
  2623.      
  2624.      SYNTAX
  2625.           [SET] CMDline Top|Bottom
  2626.      
  2627.      DESCRIPTION
  2628.           The CMDLINE command sets the position of the command line, either
  2629.           at the top of the screen or at the bottom of the screen.
  2630.      
  2631.      COMPATIBILITY
  2632.           XEDIT: Does not allow CMDLINE to be turned OFF.
  2633.           KEDIT: Compatible.
  2634.      
  2635.      STATUS
  2636.           Complete.
  2637.  
  2638.  
  2639.  
  2640.      --------------------------------------------------------------------------
  2641.      COMMAND
  2642.           colour - set colours for display
  2643.      
  2644.      SYNTAX
  2645.           [SET] COLOUR|COLOR area [modifier] [foreground background]
  2646.      
  2647.      DESCRIPTION
  2648.           The COLOUR command changes the colours or display attributes of
  2649.           various display areas in THE.
  2650.      
  2651.           Valid values for 'area':
  2652.             filearea - area containing file lines
  2653.             curline  - the current line
  2654.             block    - marked block
  2655.             cblock   - current line if in marked block
  2656.             cmdline  - command line
  2657.             idline   - line containing file specific info
  2658.             msgline  - error messages
  2659.             arrow    - command line prompt
  2660.             prefix   - prefix area
  2661.             pending  - pending commands in prefix
  2662.             scale    - line showing scale line (N/A)
  2663.             tofeof   - *** Top of File *** and *** Bottom of File *** lines
  2664.             ctofeof  - as above if the same as current line
  2665.             tabline  - line showing tab positions (N/A)
  2666.             shadow   - hidden line marker lines (N/A)
  2667.             statarea - line showing status of editing session
  2668.             divider  - dividing line between vertical split screens (N/A)
  2669.             reserved - any reserved lines
  2670.      
  2671.           Valid values for 'foreground' and 'background':
  2672.             black,blue,green,cyan,red,magenta,yellow,white
  2673.      
  2674.           Valid values for 'modifier':
  2675.             normal,blink,bold,bright,high,reverse,underline
  2676.      
  2677.           It is an error to attempt to set a colour on a mono display.
  2678.      
  2679.      COMPATIBILITY
  2680.           XEDIT: Functionally compatible. See below.
  2681.           KEDIT: Functionally compatible. See below.
  2682.           Does not implement all modifiers.
  2683.      
  2684.      STATUS  
  2685.           Complete.
  2686.  
  2687.  
  2688.  
  2689.      --------------------------------------------------------------------------
  2690.      COMMAND
  2691.           curline - set position of current line on screen
  2692.      
  2693.      SYNTAX
  2694.           [SET] CURLine M[+n|-n] | [+|-]n
  2695.      
  2696.      DESCRIPTION
  2697.           The CURLINE command sets the position of the current line to
  2698.           the physical screen line specified by supplied arguments.
  2699.      
  2700.           The two forms of parameters are:
  2701.           M[+n|-n] - this sets the current line to be relative to the
  2702.                      middle of the screen. A positvie value adds to the
  2703.                      middle line number, a negative subtracts from it.
  2704.                      eg. M+3 on a 24 line screen will be line 15
  2705.                          M-5 on a 24 line screen will be line 7
  2706.      
  2707.           [+|-]n   - this sets the current line to be relative to the
  2708.                      top of the screen (if positive or no sign) or
  2709.                      relative to the bottom of the screen if negative.
  2710.                      eg. +3 or 3 will set current line to line 3
  2711.                          -3 on a 24 line screen will be line 21
  2712.      
  2713.           If the resulting line is outside the bounds of the screen
  2714.           the position of the current line will become the middle line
  2715.           on the screen.
  2716.      
  2717.      COMPATIBILITY
  2718.           XEDIT: Compatible.
  2719.           KEDIT: Compatible.
  2720.      
  2721.      STATUS
  2722.           Complete.
  2723.  
  2724.  
  2725.  
  2726.      --------------------------------------------------------------------------
  2727.      COMMAND
  2728.           dirinclude - set the file mask for directory command
  2729.      
  2730.      SYNTAX
  2731.           [SET] DIRInclude * 
  2732.           [SET] DIRInclude [Normal] [Readonly] [System] [Hidden] [Directory]
  2733.      
  2734.      DESCRIPTION
  2735.           The DIRINCLUDE command sets the file mask for files that will be
  2736.           displayed on subsequent DIRECTORY commands.
  2737.           * will set the mask to all files, the other options will set the
  2738.           mask to include those options specified together with "normal"
  2739.           files eg.
  2740.      
  2741.            DIRINCLUDE R S
  2742.      
  2743.           will display readonly and system files together with "normal" files
  2744.           the next time the DIRECTORY command is issued.
  2745.      
  2746.           The effects of DIRINCLUDE are ignored in the Unix version.
  2747.      
  2748.      COMPATIBILITY
  2749.           XEDIT: N/A
  2750.           KEDIT: N/A
  2751.      
  2752.      SEE ALSO
  2753.           directory
  2754.      
  2755.      STATUS
  2756.           Complete.
  2757.  
  2758.  
  2759.  
  2760.      --------------------------------------------------------------------------
  2761.      COMMAND
  2762.           display - specify which level of lines to display
  2763.      
  2764.      SYNTAX
  2765.           [SET] DISPlay n [m|*]
  2766.      
  2767.      DESCRIPTION
  2768.           The DISPLAY command sets the selection level for lines to be
  2769.           displayed on the screen.
  2770.      
  2771.      COMPATIBILITY
  2772.           XEDIT: Compatible.
  2773.           KEDIT: Compatible.
  2774.      
  2775.      SEE ALSO
  2776.           SET SCOPE, SET SELECT, ALL
  2777.      
  2778.      STATUS
  2779.           Not started.
  2780.  
  2781.  
  2782.  
  2783.      --------------------------------------------------------------------------
  2784.      COMMAND
  2785.           eolout - set end of line terminator
  2786.      
  2787.      SYNTAX
  2788.           [SET] EOLout CRLF|LF
  2789.      
  2790.      DESCRIPTION
  2791.           The EOLOUT command allows the user to specify the combination of
  2792.           characters that terminate a line. Lines of text in U*ix files are
  2793.           usually terminated with a LF, whereas in DOS they usually end with
  2794.           a CR and LF combination.
  2795.      
  2796.      COMPATIBILITY
  2797.           XEDIT: N/A
  2798.           KEDIT: N/A
  2799.      
  2800.      STATUS
  2801.           Complete.
  2802.  
  2803.  
  2804.  
  2805.      --------------------------------------------------------------------------
  2806.      COMMAND
  2807.           etmode - indicate if extended display mode is possible
  2808.      
  2809.      SYNTAX
  2810.           [SET] ETMODE ON|OFF
  2811.      
  2812.      DESCRIPTION
  2813.           The ETMODE command allows the user to specify if extended ASCII
  2814.           codes ( > 127) are to be displayed or should be displayed as
  2815.           the NONDISP character.
  2816.      
  2817.      COMPATIBILITY
  2818.           XEDIT: Similar function but deals with Double-Byte characters
  2819.           KEDIT: N/A
  2820.      
  2821.      DEFAULT
  2822.           ON  - for DOS and OS/2 platforms
  2823.           OFF - for other platforms
  2824.      
  2825.      SEE ALSO
  2826.           [SET] NONDisp
  2827.      
  2828.      STATUS
  2829.           Complete.
  2830.  
  2831.  
  2832.  
  2833.      --------------------------------------------------------------------------
  2834.      COMMAND
  2835.           hex - set how hexidecimal strings are treated in string operands
  2836.      
  2837.      SYNTAX
  2838.           [SET] HEX ON|OFF
  2839.      
  2840.      DESCRIPTION
  2841.           The HEX set command determines whether hexidecimal strings are
  2842.           treated as such in string operands.
  2843.           With HEX ON, any string operand of the form
  2844.              /x'31 32 33'/ or
  2845.              /d'49 50 51'/
  2846.           will be converted to /123/ before the command is executed.
  2847.           With HEX OFF, no conversion is done.
  2848.      
  2849.           This conversion should work wherever a string operand is used
  2850.           in any command.
  2851.      
  2852.      COMPATIBILITY
  2853.           XEDIT: Adds support for decimal representation. See below.
  2854.           KEDIT: Compatible. See below.
  2855.           Spaces must seperate each character representation.
  2856.      
  2857.      DEFAULT
  2858.           HEX OFF
  2859.      
  2860.      STATUS
  2861.           Complete.
  2862.  
  2863.  
  2864.  
  2865.      --------------------------------------------------------------------------
  2866.      COMMAND
  2867.           hexdisplay - turn on or display of character under cursor
  2868.      
  2869.      SYNTAX
  2870.           [SET] HEXDISPlay ON|OFF
  2871.      
  2872.      DESCRIPTION
  2873.           The HEXDISPLAY command turns on or off the display of the character under
  2874.           the cursor on the status line.
  2875.      
  2876.      COMPATIBILITY
  2877.           XEDIT: N/A
  2878.           KEDIT: Compatible.
  2879.      
  2880.      DEFAULT
  2881.           ON - the current character is displayed.
  2882.      
  2883.      STATUS
  2884.           Complete
  2885.  
  2886.  
  2887.  
  2888.      --------------------------------------------------------------------------
  2889.      COMMAND
  2890.           impmacro - set implied macro command processing
  2891.      
  2892.      SYNTAX
  2893.           [SET] IMPMACro ON|OFF
  2894.      
  2895.      DESCRIPTION
  2896.           The IMPMACRO command is used to toggle implied macro processing
  2897.           from the command line. By turning this feature on you can then
  2898.           issue a macro command without the need to prefix the macro name
  2899.           with the MACRO command.
  2900.      
  2901.      COMPATIBILITY
  2902.           XEDIT: N/A
  2903.           KEDIT: Compatible.
  2904.      
  2905.      DEFAULT
  2906.           ON
  2907.      
  2908.      SEE ALSO
  2909.           Macro,Macropath
  2910.      
  2911.      STATUS
  2912.           Complete.
  2913.  
  2914.  
  2915.  
  2916.      --------------------------------------------------------------------------
  2917.      COMMAND
  2918.           impos - set implied operating system command processing
  2919.      
  2920.      SYNTAX
  2921.           [SET] IMPOS ON|OFF
  2922.           [SET] IMPcmscp ON|OFF
  2923.      
  2924.      DESCRIPTION
  2925.           The IMPMOS command is used to toggle implied operating system
  2926.           command processing from the command line. By turning this feature 
  2927.           on you can then issue an operating system command without the need 
  2928.           to prefix the operating system command with the OS command.
  2929.      
  2930.      COMPATIBILITY
  2931.           XEDIT: Compatible.
  2932.           KEDIT: N/A
  2933.      
  2934.      DEFAULT
  2935.           ON
  2936.      
  2937.      STATUS
  2938.           Complete.
  2939.  
  2940.  
  2941.  
  2942.      --------------------------------------------------------------------------
  2943.      COMMAND
  2944.           insertmode - put editor into insert mode
  2945.      
  2946.      SYNTAX
  2947.           [SET] INSERTMode ON|OFF|TOGGLE
  2948.      
  2949.      DESCRIPTION
  2950.           The INSERTMODE command toggles the insert mode within THE.
  2951.      
  2952.      COMPATIBILITY
  2953.           XEDIT: N/A
  2954.           KEDIT: Compatible.
  2955.      
  2956.      DEFAULT
  2957.           TOGGLE
  2958.      
  2959.      STATUS
  2960.           Complete.
  2961.  
  2962.  
  2963.  
  2964.      --------------------------------------------------------------------------
  2965.      COMMAND
  2966.           linend - allow/disallow multiple commands on command line
  2967.      
  2968.      SYNTAX
  2969.           [SET] LINENd ON|OFF [char]
  2970.      
  2971.      DESCRIPTION
  2972.           The LINEND command allows or disallows the execution of multiple
  2973.           commands on the command line. When setting LINEND ON, a character
  2974.           is specified as the LINEND character which delimits each command.
  2975.      
  2976.      COMPATIBILITY
  2977.           XEDIT: N/A
  2978.           KEDIT: Compatible.
  2979.      
  2980.      DEFAULT
  2981.           OFF #
  2982.      
  2983.      STATUS
  2984.           Complete.
  2985.  
  2986.  
  2987.  
  2988.      --------------------------------------------------------------------------
  2989.      COMMAND
  2990.           macroext - set default macro extension value
  2991.      
  2992.      SYNTAX
  2993.           [SET] MACROExt [ext]
  2994.      
  2995.      DESCRIPTION
  2996.           The MACROEXT command sets the value of the file extension to be
  2997.           used for macro files. When a macro file name is specified on the
  2998.           command line, a fullstop '.' then this value will be appended.
  2999.           If no value is specified for ext, then THE assumes that the
  3000.           supplied macro file name is the fully specified name for a macro.
  3001.      
  3002.           The length of ext must be 10 characters or less.
  3003.      
  3004.           The macro extension is only appended to a file if that file does
  3005.           not include any path specifiers.
  3006.      
  3007.      COMPATIBILITY
  3008.           XEDIT: N/A
  3009.           KEDIT: N/A
  3010.      
  3011.      DEFAULT
  3012.           the
  3013.      
  3014.      STATUS
  3015.           Complete.
  3016.  
  3017.  
  3018.  
  3019.      --------------------------------------------------------------------------
  3020.      COMMAND
  3021.           macropath - set up default path for macro commands
  3022.      
  3023.      SYNTAX
  3024.           [SET] MACROPath path[s]
  3025.      
  3026.      DESCRIPTION
  3027.           The MACROPATH command sets up the search path from which macro
  3028.           command files are executed. Each directory is seperated by a
  3029.           colon (Unix) or semi-colon (DOS & OS/2).
  3030.           No check is done at this stage to validate the supplied path.
  3031.      
  3032.      COMPATIBILITY
  3033.           XEDIT: N/A
  3034.           KEDIT: Incompatible.
  3035.      
  3036.      DEFAULT
  3037.           Path specified by env variable THE_MACRO_PATH or directory
  3038.           specified in THE_HOME_DIR followed by the current directory
  3039.           if THE_MACRO_PATH not defined.
  3040.      
  3041.      SEE ALSO
  3042.           Macro,Impmacro.
  3043.      
  3044.      STATUS
  3045.           Complete.
  3046.  
  3047.  
  3048.  
  3049.      --------------------------------------------------------------------------
  3050.      COMMAND
  3051.           margins - set left and right margins
  3052.      
  3053.      SYNTAX
  3054.           [SET] MARgins left right [[+|-]indent]
  3055.      
  3056.      DESCRIPTION
  3057.           The MARGINS command sets the left and right margins and the
  3058.           number of columns to indent a paragraph.
  3059.           These values are used with the WORDWRAP option.
  3060.      
  3061.      COMPATIBILITY
  3062.           XEDIT: N/A
  3063.           KEDIT: Compatible.
  3064.      
  3065.      DEFAULT
  3066.           1 72 0
  3067.      
  3068.      SEE ALSO
  3069.           [SET] WORDWRAP.
  3070.      
  3071.      STATUS
  3072.           Complete.
  3073.  
  3074.  
  3075.  
  3076.      --------------------------------------------------------------------------
  3077.      COMMAND
  3078.           msgmode - set display of messages on or off
  3079.      
  3080.      SYNTAX
  3081.           [SET] MSGMode ON|OFF
  3082.      
  3083.      DESCRIPTION
  3084.           The MSGMODE set command determines whether error messages will be 
  3085.           displayed or suppressed.
  3086.      
  3087.      COMPATIBILITY
  3088.           XEDIT: Does not support [Short|Long] options.
  3089.           KEDIT: Compatible
  3090.      
  3091.      DEFAULT
  3092.           ON
  3093.      
  3094.      STATUS
  3095.           Complete
  3096.  
  3097.  
  3098.  
  3099.      --------------------------------------------------------------------------
  3100.      COMMAND
  3101.           newlines - set behaviour of adding new lines
  3102.      
  3103.      SYNTAX
  3104.           [SET] NEWLines Aligned|Left
  3105.      
  3106.      DESCRIPTION
  3107.           The NEWLINES set command determines where the cursor displays after
  3108.           a new line is added to the file.
  3109.           With ALIGNED, the cursor will display in the column of the new line
  3110.           immediately underneath the first non-blank character in the line
  3111.           above.
  3112.           With LEFT, the cursor will display in the first column of the new line.
  3113.      
  3114.      COMPATIBILITY
  3115.           XEDIT: N/A
  3116.           KEDIT: Same command, different functionality.
  3117.      
  3118.      DEFAULT
  3119.           NEWLINES ALIGNED
  3120.      
  3121.      STATUS
  3122.           Complete
  3123.  
  3124.  
  3125.  
  3126.      --------------------------------------------------------------------------
  3127.      COMMAND
  3128.           nodisp - set the character that displays for non-displaying characters
  3129.      
  3130.      SYNTAX
  3131.           [SET] NONDisp char
  3132.      
  3133.      DESCRIPTION
  3134.           The NONDISP command allows the user to change the character that 
  3135.           is displayed for non-displaying commands when [SET] ETMODE is OFF.
  3136.      
  3137.      COMPATIBILITY
  3138.           XEDIT: Compatible.
  3139.           KEDIT: N/A
  3140.      
  3141.      DEFAULT
  3142.           #
  3143.      
  3144.      SEE ALSO
  3145.           [SET] ETMODE
  3146.      
  3147.      STATUS
  3148.           Complete.
  3149.  
  3150.  
  3151.  
  3152.      --------------------------------------------------------------------------
  3153.      COMMAND
  3154.           number - turn prefix numbers on or off
  3155.      
  3156.      SYNTAX
  3157.           [SET] NUMber ON|OFF
  3158.      
  3159.      DESCRIPTION
  3160.           The NUMBER command allows the user to toggle the display of numbers
  3161.           in the prefix area.
  3162.      
  3163.      COMPATIBILITY
  3164.           XEDIT: Compatible.
  3165.           KEDIT: Compatible.
  3166.      
  3167.      DEFAULT
  3168.           ON
  3169.      
  3170.      SEE ALSO
  3171.           Prefix
  3172.      
  3173.      STATUS
  3174.           Complete.
  3175.  
  3176.  
  3177.  
  3178.      --------------------------------------------------------------------------
  3179.      COMMAND
  3180.           pending - set status of pending prefix commands
  3181.      
  3182.      SYNTAX
  3183.           [SET] PENDing ON string
  3184.           [SET] PENDing OFF
  3185.           [SET] PENDing BLOCK string
  3186.      
  3187.      DESCRIPTION
  3188.           The PENDING command allows the user to insert or remove commands
  3189.           from the pending prefix list.
  3190.      
  3191.           [SET] PENDing ON 'string', simulates the user typing 'string'
  3192.           in the prefix area of the focus line.
  3193.      
  3194.           [SET] PENDing OFF, removes any pending prefix command from the
  3195.           focus line.
  3196.      
  3197.           [SET] PENDing BLOCK 'string', simulates the user typing 'string'
  3198.           in the prefix area of the focus line and identifies the prefix 
  3199.           command to be a BLOCK command.
  3200.      
  3201.      COMPATIBILITY
  3202.           XEDIT: Does not support ERROR option.
  3203.           KEDIT: N/A
  3204.      
  3205.      STATUS
  3206.           Complete.
  3207.  
  3208.  
  3209.  
  3210.      --------------------------------------------------------------------------
  3211.      COMMAND
  3212.           point - give a name to the current line
  3213.      
  3214.      SYNTAX
  3215.           [SET] Point .name [OFF]
  3216.      
  3217.      DESCRIPTION
  3218.           The POINT command assignes the specified name to the current
  3219.           line, or removes the name from the line with the specified name.
  3220.           A valid line name must start with a '.' followed by an alphabetic
  3221.           character. eg. .a .fred and .GG are valid names; fred and .3 are
  3222.           invalid line names.
  3223.      
  3224.           When a line is moved within the same file, its line name stays
  3225.           with the line.
  3226.      
  3227.      COMPATIBILITY
  3228.           XEDIT: Compatible. See below.
  3229.           KEDIT: Compatible. See below.
  3230.           Does not allow for multiple names for the same line.
  3231.      
  3232.      STATUS
  3233.           Complete.
  3234.  
  3235.  
  3236.  
  3237.      --------------------------------------------------------------------------
  3238.      COMMAND
  3239.           prefix - set prefix area attributes
  3240.      
  3241.      SYNTAX
  3242.           [SET] PREfix ON [Left|Right]
  3243.           [SET] PREfix OFF
  3244.           [SET] PREfix Synonym newname oldname
  3245.      
  3246.      DESCRIPTION
  3247.           The first form of the PREFIX allows the user to display the
  3248.           prefix area and optionally to select the position the prefix
  3249.           should be displayed at.
  3250.           The second form, turns the display of the prefix area off.
  3251.           Executed from within the profile, the only effect is that the
  3252.           defaults for all files is changed.
  3253.           Executed from the command line, the PREFIX command changes the
  3254.           current window displays to reflect the required options.
  3255.      
  3256.           The third form of the PREFIX command allows the users to specify
  3257.           a synonym for a prefix command or REXX prefix macro. The 'newname' 
  3258.           is the command entered in the prefix area and 'oldname' corresponds 
  3259.           to an existing prefix command or a REXX macro file in the MACROPATH 
  3260.           ending in .the or whatever the value of MACROEXT is at the time the 
  3261.           prefix command is executed. The 'oldname' can also be the fully 
  3262.           qualified filename of a REXX macro.
  3263.      
  3264.      COMPATIBILITY
  3265.           XEDIT: Compatible. See below.
  3266.           KEDIT: Compatible. See below.
  3267.           Does not support PREFIX NULLS.
  3268.      
  3269.      DEFAULT
  3270.           PREFIX ON LEFT
  3271.      
  3272.      STATUS
  3273.           Strange display behaviour occurs when you have multiple files with
  3274.           mixed prefix settings.
  3275.  
  3276.  
  3277.  
  3278.      --------------------------------------------------------------------------
  3279.      COMMAND
  3280.           printer - define printer spooler name
  3281.      
  3282.      SYNTAX
  3283.           [SET] PRINTER spooler
  3284.      
  3285.      DESCRIPTION
  3286.           The PRINTER command sets up the print spooler name to determine
  3287.           where output from the PRINT command goes.
  3288.      
  3289.      COMPATIBILITY
  3290.           XEDIT: N/A
  3291.           KEDIT: Compatible.
  3292.      
  3293.      SEE ALSO
  3294.           print
  3295.      
  3296.      STATUS
  3297.           Incomplete. This command does nothing in the DOS version.
  3298.  
  3299.  
  3300.  
  3301.      --------------------------------------------------------------------------
  3302.      COMMAND
  3303.           reprofile - indicate if profile file to be executed for all files
  3304.      
  3305.      SYNTAX
  3306.           [SET] REPROFile ON|OFF
  3307.      
  3308.      DESCRIPTION
  3309.           The REPROFILE command allows the user to determine if the profile 
  3310.           file is to reexecuted for files subsequenlty edited.
  3311.      
  3312.      COMPATIBILITY
  3313.           XEDIT: N/A
  3314.           KEDIT: Compatible.
  3315.      
  3316.      DEFAULT
  3317.           OFF
  3318.      
  3319.      SEE ALSO
  3320.           xedit
  3321.      
  3322.      STATUS
  3323.           Complete
  3324.  
  3325.  
  3326.  
  3327.      --------------------------------------------------------------------------
  3328.      COMMAND
  3329.           reserved - reserve a line
  3330.      
  3331.      SYNTAX
  3332.           [SET] RESERved +|-n text|OFF
  3333.      
  3334.      DESCRIPTION
  3335.           The RESERVED command reseves a line for the display of arbitrary
  3336.           text by the user. The position is determined by +|-n.
  3337.           This number, if positive, specifies the line relative from the
  3338.           top of the display. A negative number is relative from the
  3339.           bottom of the display.
  3340.      
  3341.           By specifying a line, say +3, then THREE lines from the top will
  3342.           be reserved, with the supplied text being displayed in line 3.
  3343.      
  3344.           The idline of a file will always be displayed after any reserved
  3345.           lines.
  3346.      
  3347.           The status area will always be displayed on the very last line
  3348.           of the screen and any reserved lines will display above that.
  3349.           The status area then is effectively line -0;
  3350.      
  3351.      COMPATIBILITY
  3352.           XEDIT: Compatible. See below.
  3353.           KEDIT: Compatible. See below.
  3354.           Does not allow a colour to be specified. Use SET COLOUR instead.
  3355.      
  3356.      STATUS
  3357.           Not implemented.
  3358.  
  3359.  
  3360.  
  3361.      --------------------------------------------------------------------------
  3362.      COMMAND
  3363.           rexxoutput - indicate where REXX output is to go
  3364.      
  3365.      SYNTAX
  3366.           [SET] REXXOUTput File|Display n
  3367.      
  3368.      DESCRIPTION
  3369.           The REXXOUTPUT command indicates where output from the REXX
  3370.           interpreter is to go; either captured to a file in the ring
  3371.           or displayed in a scrolling fashion on the screen.
  3372.      
  3373.           Also specified is the maximum number of lines from the REXX
  3374.           interpreter that are to be displayed or captured. This is
  3375.           particularly useful when a REXX macro gets into an infinite
  3376.           loop.
  3377.      
  3378.      COMPATIBILITY
  3379.           XEDIT: N/A
  3380.           KEDIT: N/A
  3381.      
  3382.      DEFAULT
  3383.           Display 1000
  3384.      
  3385.      STATUS
  3386.           Complete.
  3387.  
  3388.  
  3389.  
  3390.      --------------------------------------------------------------------------
  3391.      COMMAND
  3392.           scope - sets which lines are to be excluded from commands
  3393.      
  3394.      SYNTAX
  3395.           [SET] SCOPE All|Display
  3396.      
  3397.      DESCRIPTION
  3398.           The SCOPE command indicates whether lines not displayed as
  3399.           the result of a SET DISPLAY or ALL command are included in
  3400.           the scope of lines to be acted upon by other THE commands.
  3401.      
  3402.      COMPATIBILITY
  3403.           XEDIT: Compatible.
  3404.           KEDIT: Compatible.
  3405.      
  3406.      DEFAULT
  3407.           Display
  3408.      
  3409.      SEE ALSO
  3410.           SET DISPLAY, SET SELECT, ALL
  3411.      
  3412.      STATUS
  3413.           Not started.
  3414.  
  3415.  
  3416.  
  3417.      --------------------------------------------------------------------------
  3418.      COMMAND
  3419.           screen - specifiy number of screens displayed
  3420.      
  3421.      SYNTAX
  3422.           [SET] SCReen n [Horizontal|Vertical]
  3423.      
  3424.      DESCRIPTION
  3425.           The SCREEN command specifies the number of views of file(s) to
  3426.           display on screen at once. If the number of views specified is 2
  3427.           and only one file is currently in the ring, two views of the
  3428.           same file are displayed.
  3429.      
  3430.      COMPATIBILITY
  3431.           XEDIT: Does not support Size,Width or Define options.
  3432.           KEDIT: Does not support Size option.
  3433.           Only 2 views are supported.
  3434.      
  3435.      STATUS
  3436.           Not complete. (Unavailable)
  3437.  
  3438.  
  3439.  
  3440.      --------------------------------------------------------------------------
  3441.      COMMAND
  3442.           select - sets the selection level for the specified lines
  3443.      
  3444.      SYNTAX
  3445.           [SET] SELect [+|-]n target
  3446.      
  3447.      DESCRIPTION
  3448.           The SELECT command sets the selection level for the indicated
  3449.           lines equal to n (if no signs are specified) or adds or subtracts
  3450.           n from the selection level currently set for the lines in the
  3451.           target.
  3452.      
  3453.      COMPATIBILITY
  3454.           XEDIT: Compatible.
  3455.           KEDIT: Compatible.
  3456.      
  3457.      SEE ALSO
  3458.           SET SCOPE, SET SELECT, ALL
  3459.      
  3460.      STATUS
  3461.           Not started.
  3462.  
  3463.  
  3464.  
  3465.      --------------------------------------------------------------------------
  3466.      COMMAND
  3467.           stay - set condition of cursor position after CHANGE/LOCATE commands
  3468.      
  3469.      SYNTAX
  3470.           [SET] STAY ON|OFF
  3471.      
  3472.      DESCRIPTION
  3473.           The STAY set command determines what line is displayed as the current
  3474.           line after an unsuccessful LOCATE command or after a CHANGE command.
  3475.           With STAY ON, the current line remains where it currently is. With
  3476.           STAY OFF, after an unsuccessful LOCATE, the current line is "Bottom
  3477.           of File". After a successful CHANGE, the current line is the last
  3478.           line affected by the CHANGE command.
  3479.      
  3480.      COMPATIBILITY
  3481.           XEDIT: Compatible.
  3482.           KEDIT: Compatible.
  3483.      
  3484.      DEFAULT
  3485.           STAY ON
  3486.      
  3487.      STATUS
  3488.           Complete
  3489.  
  3490.  
  3491.  
  3492.      --------------------------------------------------------------------------
  3493.      COMMAND
  3494.           tabkey - set characteristics of the tab key
  3495.      
  3496.      SYNTAX
  3497.           [SET] TABKey Tab|Character Tab|Character
  3498.      
  3499.      DESCRIPTION
  3500.           The TABKEY sets the action to be taken when the tab key is hit.
  3501.           Depending on the insert mode, the tab key will either display
  3502.           a raw tab character or will move to the next tab column.
  3503.           The first operand refers to the behaviour of the TAB key when
  3504.           INSERTMODE is OFF; the second operand specifies the behaviour
  3505.           when the TAB key is hit when INSERTMODE is ON.
  3506.      
  3507.      COMPATIBILITY
  3508.           XEDIT: N/A
  3509.           KEDIT: N/A
  3510.      
  3511.      DEFAULT
  3512.           TAB CHARACTER
  3513.      
  3514.      STATUS
  3515.           Complete
  3516.  
  3517.  
  3518.  
  3519.      --------------------------------------------------------------------------
  3520.      COMMAND
  3521.           tabs - set tab length for TAB key
  3522.      
  3523.      SYNTAX
  3524.           [SET] TABS INCR n
  3525.      
  3526.      DESCRIPTION
  3527.           The TABS command determines the position of tab columns when the
  3528.           TAB key is pressed.
  3529.      
  3530.      COMPATIBILITY
  3531.           XEDIT: Does not support specification of actual tab columns.
  3532.           KEDIT: Does not support specification of actual tab columns.
  3533.      
  3534.      SEE ALSO
  3535.           SOS TABF
  3536.      
  3537.      STATUS
  3538.           Complete.
  3539.  
  3540.  
  3541.  
  3542.      --------------------------------------------------------------------------
  3543.      COMMAND
  3544.           tabsin - set tab processing on file input
  3545.      
  3546.      SYNTAX
  3547.           [SET] TABSIn ON|OFF [n]
  3548.      
  3549.      DESCRIPTION
  3550.           The TABSIN command determines if tabs read from a file are to be
  3551.           expanded to spaces and if so how many spaces.
  3552.      
  3553.      COMPATIBILITY
  3554.           XEDIT: N/A
  3555.           KEDIT: Does not support TABQUOTE option.
  3556.      
  3557.      SEE ALSO
  3558.           tabsout
  3559.      
  3560.      STATUS
  3561.           Complete.
  3562.  
  3563.  
  3564.  
  3565.      --------------------------------------------------------------------------
  3566.      COMMAND
  3567.           tabsout - set tab processing on file output
  3568.      
  3569.      SYNTAX
  3570.           [SET] TABSOut ON n
  3571.           [SET] TABSOut OFF
  3572.      
  3573.      DESCRIPTION
  3574.           The TABSOUT command determines if spaces written to a file are to be
  3575.           compressed to tabs and if so how many spaces.
  3576.      
  3577.      COMPATIBILITY
  3578.           XEDIT: N/A
  3579.           KEDIT: Compatible.
  3580.      
  3581.      SEE ALSO
  3582.           tabsin
  3583.      
  3584.      STATUS
  3585.           Complete.
  3586.  
  3587.  
  3588.  
  3589.      --------------------------------------------------------------------------
  3590.      COMMAND
  3591.           verify - set column display limits
  3592.      
  3593.      SYNTAX
  3594.           [SET] Verify first [last]
  3595.      
  3596.      DESCRIPTION
  3597.           The VERIFY command sets the column limits for the display of the
  3598.           current file. 'first' specifies the first column to be displayed
  3599.           and 'last' specifies the last column to be displayed.
  3600.      
  3601.           If no 'last' option is specified '*' is assumed.
  3602.      
  3603.      COMPATIBILITY
  3604.           XEDIT: Does not implement HEX display nor multiple column pairs.
  3605.           KEDIT: Does not implement HEX display nor multiple column pairs.
  3606.      
  3607.      SEE ALSO
  3608.           Zone
  3609.      
  3610.      STATUS
  3611.           Complete.
  3612.  
  3613.  
  3614.  
  3615.      --------------------------------------------------------------------------
  3616.      COMMAND
  3617.           wordwrap - set wordwrap feature on or off
  3618.      
  3619.      SYNTAX
  3620.           [SET] WORDWrap ON|OFF
  3621.      
  3622.      DESCRIPTION
  3623.           The WORDWRAP set command determines whether wordwrap occurs when
  3624.           the cursor moves past the right margin (as set my [SET] MARGINS 
  3625.           command).
  3626.           With WORDWRAP ON, the line, from the beginning of the word that
  3627.           exceeds the right margin, is wrapped onto the next line. The cursor
  3628.           position stays in the same position relative to the current word.
  3629.           WIth WORDWRAP OFF, no word wrap occurs.
  3630.      
  3631.      COMPATIBILITY
  3632.           XEDIT: N/A
  3633.           KEDIT: Compatible.
  3634.      
  3635.      DEFAULT
  3636.           WORDWRAP OFF
  3637.      
  3638.      STATUS
  3639.           Complete.
  3640.  
  3641.  
  3642.  
  3643.      --------------------------------------------------------------------------
  3644.      COMMAND
  3645.           zone - set column limits for editing
  3646.      
  3647.      SYNTAX
  3648.           [SET] Zone first [last]
  3649.      
  3650.      DESCRIPTION
  3651.           The ZONE command sets the column limits for various other editor
  3652.           commands, such as 'locate' and 'change'. It effectively restricts
  3653.           to the specified columns those parts of the file which can be
  3654.           acted upon.
  3655.      
  3656.           If no 'last' option is specified '*' is assumed.
  3657.      
  3658.      COMPATIBILITY
  3659.           XEDIT: Compatible.
  3660.           KEDIT: Compatible.
  3661.      
  3662.      SEE ALSO
  3663.           Verify
  3664.      
  3665.      STATUS
  3666.           Complete.
  3667.  
  3668.  
  3669.  
  3670.      --------------------------------------------------------------------------
  3671.      
  3672.      
  3673.      ========================================================================
  3674.      QUERY, EXTRACT and STATUS
  3675.      ========================================================================
  3676.      
  3677.           The following lists the valid variables that can be queried and
  3678.           also shows what values are returned. For both QUERY and STATUS,
  3679.           the values are concatenated together and displayed as a single
  3680.           line. For EXTRACT the REXX variables that are set are defined.
  3681.           The capitalised portion of the variable is the minimum abbreviation
  3682.           recognised.
  3683.           The bracketed text at the end of the description indicates from
  3684.           which commands a valid response will be supplied (Q-Query,E-Extract
  3685.           and S-Status).
  3686.      
  3687.      ALT
  3688.           The number of alterations to the current file since the last SAVE
  3689.           or AUTOSAVE.
  3690.           (QES)
  3691.      
  3692.           alt.0           - 2
  3693.           alt.1           - Number of alterations since last SAVE or AUTOSAVE
  3694.           alt.2           - Number of alterations since last SAVE
  3695.      
  3696.      ARBchar
  3697.           The status of ARBCHAR and the ARBCHAR character.
  3698.           (QES)
  3699.      
  3700.           arbchar.0       - 2
  3701.           arbchar.1       - ON|OFF
  3702.           arbchar.2       - ARBCHAR character
  3703.      
  3704.      AUtosave
  3705.           The status of AUTOSAVE and/or the frequency setting.
  3706.           (QES)
  3707.      
  3708.           autosave.0      - 1
  3709.           autosave.1      - OFF|n
  3710.      
  3711.      BACKup
  3712.           Indicates if a .bak file is kept after editing.
  3713.           (QES)
  3714.      
  3715.           backup.0        - 1
  3716.           backup.1        - ON|OFF
  3717.      
  3718.      BEEP
  3719.           Indicates if the bell is sounded on display of error messages.
  3720.           (QES)
  3721.      
  3722.           beep.0          - 1
  3723.           beep.1          - ON|OFF
  3724.      
  3725.      BLOCK
  3726.           Returns information about the marked block, if any.
  3727.           (E)
  3728.      
  3729.           block.0         - 6 if a marked block exists, or 1 for NONE
  3730.           block.1         - type of marked block (LINE|BOX|NONE)
  3731.           block.2         - line number of start of block
  3732.           block.3         - column number of start of block
  3733.           block.4         - line number of end of block
  3734.           block.5         - column number of end of block
  3735.           block.6         - file name containing marked block
  3736.      
  3737.      CASE
  3738.           The settings related to the CASE of characters entered, searched
  3739.           for, changed and sorted.
  3740.           (QES)
  3741.      
  3742.           case.0          - 4
  3743.           case.1          - MIXED|UPPER|LOWER
  3744.           case.2          - RESPECT|IGNORE
  3745.           case.3          - RESPECT|IGNORE
  3746.           case.4          - RESPECT|IGNORE
  3747.      
  3748.      CLEARScreen
  3749.           Indicates if the screen is cleared on exit from THE.
  3750.           (QES)
  3751.      
  3752.           clearscreen.0   - 1
  3753.           clearscreen.1   - ON|OFF
  3754.      
  3755.      CLOCK
  3756.           Indicates if the time is displayed on the status line.
  3757.           (QES)
  3758.      
  3759.           clock.0         - 1
  3760.           clock.1         - ON|OFF
  3761.      
  3762.      CMDArrows
  3763.           Returns the settings for arrow key behaviour.
  3764.           (QES)
  3765.      
  3766.           cmdarrows.0     - 3
  3767.           cmdarrows.1     - RETRIEVE|TAB
  3768.           cmdarrows.2     - SCROLL|TAB
  3769.           cmdarrows.3     - SCROLL|TAB
  3770.      
  3771.      CMDline
  3772.           The settings for the command line.
  3773.           (QES)
  3774.      
  3775.           cmdline.0       - 3
  3776.           cmdline.1       - TOP|BOTTOM
  3777.           cmdline.2 *     - line number within window of command line
  3778.           cmdline.3 *     - contents of command line
  3779.                     * these values are only returned with EXTRACT
  3780.      
  3781.      CURline
  3782.           The value and position of the current line within the current file.
  3783.           (E)
  3784.      
  3785.           curline.0       - 3
  3786.           curline.1       - -1
  3787.           curline.2       - line number within window of current line
  3788.           curline.3       - contents of current line
  3789.      
  3790.      DIRFILEID
  3791.           The value of the path and filename of the focus line in a DIR.DIR
  3792.           file.
  3793.           (E)
  3794.      
  3795.           dirfileid.0     - 2
  3796.           dirfileid.1     - full path of directory
  3797.           dirfileid.2     - file name at focus line
  3798.      
  3799.      EOF
  3800.           Indicates if the current line is on the *** Bottom of file *** line.
  3801.           (QES)
  3802.      
  3803.           eof.0           - 1
  3804.           eof.2           - ON|OFF
  3805.      
  3806.      EOLout
  3807.           Returns the value of the end-of-line character(s).
  3808.           (QES)
  3809.      
  3810.           eolout.0        - 1
  3811.           eolout.1        - LF|CRLF
  3812.      
  3813.      ETMODE
  3814.           Indicates if extended display mode is set.
  3815.           (QES)
  3816.      
  3817.           etmode.0        - 1
  3818.           etmode.1        - ON|OFF
  3819.      
  3820.      FNAME
  3821.           The file name of the current file.
  3822.           (E)
  3823.      
  3824.           fname.0         - 1
  3825.           fname.1         - File name.
  3826.      
  3827.      FPATH
  3828.           The path name of the current file. This includes a trailing
  3829.           directory seperator.
  3830.           (E)
  3831.      
  3832.           fpath.0         - 1
  3833.           fpath.1         - File path.
  3834.      
  3835.      FTYPE
  3836.           The extension of the current file. The characters following
  3837.           the trailing '.' character.
  3838.           (E)
  3839.      
  3840.           ftype.0         - 1
  3841.           ftype.1         - File extension.
  3842.      
  3843.      GETENV variable
  3844.           The value of the supplied environment variable or ***invalid***
  3845.           if the variable does not exist.
  3846.           (E)
  3847.      
  3848.           getenv.0        - 1
  3849.           getenv.1        - value of variable
  3850.      
  3851.      HEX
  3852.           Indicates if HEX is on or off.
  3853.           (QES)
  3854.      
  3855.           hex.0           - 1
  3856.           hex.1           - ON|OFF
  3857.      
  3858.      HEXDISPlay
  3859.           Indicates if the current character is displayed on the status line.
  3860.           (QES)
  3861.      
  3862.           hexdisplay.0    - 1
  3863.           hexdisplay.1    - ON|OFF
  3864.      
  3865.      IMPMACro
  3866.           Indicates if implied macro processing is on or off.
  3867.           (QES)
  3868.      
  3869.           impmacro.0      - 1
  3870.           impmacro.1      - ON|OFF
  3871.      
  3872.      IMPOS
  3873.           Indicates if implied operating system command processing is on 
  3874.           or off.
  3875.           (QES)
  3876.      
  3877.           impos.0         - 1
  3878.           impos.1         - ON|OFF
  3879.      
  3880.      INSERTmode
  3881.           Indicates if currently in insert mode or overstrike mode.
  3882.           (QES)
  3883.      
  3884.           insertmode.1    - 1
  3885.           insertmode.1    - ON|OFF
  3886.      
  3887.      LASTmsg
  3888.           Return the text of the last error message generated.
  3889.           (E)
  3890.      
  3891.           lastmsg.0       - 1
  3892.           lastmsg.1       - text of last message.
  3893.      
  3894.      LASTRC
  3895.           Return code from last command issued from command line.
  3896.           (QES)
  3897.      
  3898.           lastrc.0        - 1
  3899.           lastrc.1        - Last return code.
  3900.      
  3901.      LENgth
  3902.           Length of the current line.
  3903.           (QES)
  3904.      
  3905.           length.0        - 1
  3906.           length.1        - Length of current line.
  3907.      
  3908.      LIne
  3909.           Line number of current line in current file.
  3910.           (QES)
  3911.      
  3912.           line.0          - 1
  3913.           line.1          - Line number
  3914.      
  3915.      LINENd
  3916.           Indicates if multiple commands allowed on command line
  3917.           and the delimiter.
  3918.           (QES)
  3919.      
  3920.           linend.0        - 2
  3921.           linend.1        - ON|OFF
  3922.           linend.2        - delimiter
  3923.      
  3924.      MACROExt
  3925.           The current setting for a macro's file extension.
  3926.           (QES)
  3927.      
  3928.           macroext.0      - 1
  3929.           macroext.1      - Default file extension
  3930.      
  3931.      MACROPath
  3932.           The path that THE looks for by default for macro files.
  3933.           (E)
  3934.      
  3935.           macropath.0     - 1
  3936.           macropath.1     - Path for macro files.
  3937.      
  3938.      MARgins
  3939.           The settings for left and right margins and paragraph indent.
  3940.           (QES)
  3941.      
  3942.           margins.0       - 3
  3943.           margins.1       - left column
  3944.           margins.2       - right column
  3945.           margins.3       - indent value (column or offset from left margin)
  3946.      
  3947.      MONITOR
  3948.           Indicates if the combination of monitor and the curses package
  3949.           supports colour. If the curses package supports colour, then
  3950.           monitor.3 is set to COLOR and monitor.2 can be COLOR or MONO
  3951.           depending on whether the monitor supports colour. If monitor.3
  3952.           is MONO then monitor.2 will also be set to MONO.
  3953.           (QES)
  3954.      
  3955.           monitor.0       - 2
  3956.           monitor.1       - COLOR|MONO
  3957.           monitor.2       - COLOR|MONO
  3958.      
  3959.      MSGMode
  3960.           Indicates if MSGMODE setting is on or off.
  3961.           (QES)
  3962.      
  3963.           msgmode.0       - 1
  3964.           msgmode.1       - ON|OFF
  3965.      
  3966.      NBFile
  3967.           Returns with the number of files currently in the ring.
  3968.           (QES)
  3969.      
  3970.           nbfile.0        - 1
  3971.           nbfile.1        - Number of files in ring
  3972.      
  3973.      NEWLines
  3974.           Indicates if NEWLINES variable is set to LEFT or ALIGNED.
  3975.           (QES)
  3976.      
  3977.           newlines.0      - 1
  3978.           newlines.1      - ALIGNED|LEFT
  3979.      
  3980.      NONDisp
  3981.           Returns the character that is displayed for extended characters
  3982.           that are not displayed.
  3983.           (QES)
  3984.      
  3985.           nondisp.0       - 1
  3986.           nondisp.1       - char
  3987.      
  3988.      NUMber
  3989.           Indicates if line numbers are displayed in the prefix area.
  3990.           (QES)
  3991.      
  3992.           number.0        - 1
  3993.           number.1        - ON|OFF
  3994.      
  3995.      PENDing [BLOCK] [OLDNAME] name|*
  3996.           Returns information about pening prefix commands.
  3997.           (E)
  3998.      
  3999.           pending.0       - 4
  4000.           pending.1       - line number in file
  4001.           pending.2       - newname - actual name entered in prefix area
  4002.           pending.3       - oldname - original name of macro after
  4003.                                       synonym resolution
  4004.           pending.4       - BLOCK or null
  4005.      
  4006.      Point [*]
  4007.           Returns the name and line number of the focus line, or names and
  4008.           line numbers of all lines in a file if '*' is specified.
  4009.           (E)
  4010.      
  4011.           When 'EXTract /Point' is specified:
  4012.      
  4013.           point.0         - 0 or 1       (0 if focus line not named)
  4014.           point.1         - line number and name of line (if line is named)
  4015.      
  4016.           When 'EXTract /Point *' is specified:
  4017.      
  4018.           point.0         - number of named lines in the file
  4019.           point.1         - line number and name for first named line
  4020.           point.n         - line number and name for nth named line
  4021.      
  4022.      PREfix [Synonym name|*]
  4023.           Indicates if prefix is displayed for the view and if displayed
  4024.           where is is displayed.
  4025.           (QES)
  4026.      
  4027.           prefix.0        - 1 or 2     (1 if prefix.1 is OFF, 2 otherwise)
  4028.           prefix.1        - ON|OFF
  4029.           prefix.2        - LEFT|RIGHT                 (if prefix.1 is ON)
  4030.      
  4031.           With [Synonym name] option, the name of the macrofile (oldname) 
  4032.           is returned that is associated with the synonym, name. If name 
  4033.           is not a synonym then name is returned.
  4034.           (E)
  4035.      
  4036.           prefix.0        - 1
  4037.           prefix.1        - oldname
  4038.      
  4039.           With [Synonym *] option, all prefix synonyms are returned.
  4040.           (E)
  4041.      
  4042.           prefix.0        - number of prefix synonyms
  4043.           prefix.1        - newname oldname
  4044.           prefix.n        - newname oldname
  4045.      
  4046.      PRINTER
  4047.           Returns the value of the printer port or spooler.
  4048.           (QES)
  4049.      
  4050.           printer.0       - 1
  4051.           printer.1       - port or spooler name
  4052.      
  4053.      REPROFile
  4054.           Indicates if the profile file is to be re-executed for each
  4055.           subsequent file to be edited.
  4056.           (QES)
  4057.      
  4058.           reprofile.0     - 1
  4059.           reprofile.1     - ON|OFF
  4060.      
  4061.      REXXOUTput
  4062.           Indicates if REXX output is captured to a file or not and the
  4063.           line number limit of lines to be displayed.
  4064.           (QES)
  4065.      
  4066.           rexxoutput.0    - 2
  4067.           rexxoutput.1    - FILE|DISPLAY
  4068.           rexxoutput.2    - line number limit
  4069.      
  4070.      SIze
  4071.           Returns the number of lines in the current file.
  4072.           (QES)
  4073.      
  4074.           size.0          - 1
  4075.           size.1          - Lines in current file.
  4076.      
  4077.      STAY
  4078.           Indicates if STAY is on or off.
  4079.           (QES)
  4080.      
  4081.           stay.0          - 1
  4082.           stay.1          - ON|OFF
  4083.      
  4084.      TABKey
  4085.           Returns settings about behaviour of TAB key.
  4086.           tabkey.1 is behaviour while in insert mode
  4087.           tabkey.2 is behaviour while not in insert mode
  4088.           (QES)
  4089.      
  4090.           tabkey.0        - 2
  4091.           tabkey.1        - TAB|CHARACTER
  4092.           tabkey.2        - TAB|CHARACTER
  4093.      
  4094.      TABS
  4095.           Returns settings about tab columns.
  4096.           (QES)
  4097.      
  4098.           tabs.0          - 2
  4099.           tabs.1          - INCR
  4100.           tabs.2          - size of tab
  4101.      
  4102.      TABSIn
  4103.           Indicates if TABSIN processing is on or off and the size of the
  4104.           tabs setting.
  4105.           (QES)
  4106.      
  4107.           tabsin.0        - 2
  4108.           tabsin.1        - ON|OFF
  4109.           tabsin.2        - size of tabs
  4110.      
  4111.      TABSOut
  4112.           Indicates if TABSOUT processing is on or off and the size of the
  4113.           tabs setting.
  4114.           (QES)
  4115.      
  4116.           tabsout.0       - 2
  4117.           tabsout.1       - ON|OFF
  4118.           tabsout.2       - size of tabs
  4119.      
  4120.      TERMinal
  4121.           Identifies the terminal type currently being used.
  4122.           (QES)
  4123.      
  4124.           terminal.0      - 1
  4125.           terminal.1      - DOS|OS2|$TERM value under Unix
  4126.      
  4127.      TOF
  4128.           Indicates if the current line is on the *** Top of file *** line.
  4129.           (QES)
  4130.      
  4131.           tof.0           - 1
  4132.           tof.2           - ON|OFF
  4133.      
  4134.      Verify
  4135.           Returns verify column settings.
  4136.           (QES)
  4137.      
  4138.           verify.0        - 1
  4139.           verify.1        - Column pair of verify start and end columns.
  4140.      
  4141.      VERSION
  4142.           Returns information about name of application (THE) and version
  4143.           information.
  4144.           (QES)
  4145.      
  4146.           version.0       - 4
  4147.           version.1       - THE
  4148.           version.3       - version string eg. 1.5
  4149.           version.3       - platform version (DOS,OS2,UNIX)
  4150.           version.4       - version status information eg. beta
  4151.      
  4152.      Width
  4153.           Returns maximum line width setting.
  4154.           (QES)
  4155.      
  4156.           width.0         - 1
  4157.           width.1         - Maximum line width value.
  4158.      
  4159.      WORDWrap
  4160.           Indicates if WORDWARP is on or off.
  4161.           (QES)
  4162.      
  4163.           wordwrap.0      - 1
  4164.           wordwrap.1      - ON|OFF
  4165.      
  4166.      Zone
  4167.           Returns zone column settings.
  4168.           (QES)
  4169.      
  4170.           zone.0          - 2
  4171.           zone.1          - Zone start column
  4172.           zone.2          - Zone end column
  4173.      
  4174.      
  4175.      
  4176.      ========================================================================
  4177.      IMPLIED EXTRACT, BOOLEAN and OTHER FUNCTIONS
  4178.      ========================================================================
  4179.      
  4180.      IMPLIED EXTRACT
  4181.      
  4182.           The above REXX variables set above by the EXTRACT command may also
  4183.           be obtained by a REXX macro as an implied EXTRACT. Each variable
  4184.           above that may be set by an explicit EXTRACT command may also be
  4185.           used as an external function to REXX to obtain the same information.
  4186.           eg. The REXX commands:
  4187.      
  4188.               'EXTRACT /SIZE/CURLINE/'
  4189.               Say size.1 curline.1
  4190.      
  4191.           may be substituted with:
  4192.      
  4193.               Say size.1() curline.1()
  4194.      
  4195.      BOOLEAN FUNCTIONS
  4196.      
  4197.           THE also provides other information to the REXX interpreter via
  4198.           boolean functions. These functions return either '1' or '0'
  4199.           depending on the information queried.
  4200.      
  4201.        after()
  4202.           Returns '1' if the cursor is currently after the last non-blank
  4203.           character on the line, or if the line is blank.
  4204.      
  4205.        blank()
  4206.           Returns '1' if the line the cursor is on is completely blank.
  4207.      
  4208.        block()
  4209.           Returns '1' if the marked block is within the current view.
  4210.      
  4211.        before()
  4212.           Returns '1' if the cursor is currently before the first non-blank
  4213.           character on the line, or if the line is blank.
  4214.      
  4215.        bottomedge()
  4216.           Returns '1' if the cursor is on the bottom edge of the filearea
  4217.           or prefix area.
  4218.      
  4219.        command()
  4220.           Returns '1' if the cursor is on the command line.
  4221.      
  4222.        current()
  4223.           Returns '1' if the cursor is on the current line.
  4224.      
  4225.        dir()
  4226.           Returns '1' if the current file is the special DIR.DIR file.
  4227.      
  4228.        end()
  4229.           Returns '1' if the cursor is on the last non-blank character on
  4230.           the line.
  4231.      
  4232.        eof()
  4233.           Returns '1' if the cursor is on the '*** Bottom of file ***' line
  4234.           and the cursor is not on the command line.
  4235.      
  4236.        first()
  4237.           Returns '1' if the cursor is in column 1 of the current window.
  4238.      
  4239.        focuseof()
  4240.           Returns '1' if the focus line is the '*** Bottom of file ***' line
  4241.           whether the cursor is on it or not.
  4242.      
  4243.        focustof()
  4244.           Returns '1' if the focus line is the '*** Top of file ***' line
  4245.           whether the cursor is on it or not.
  4246.      
  4247.        inblock()
  4248.           Returns '1' if the cursor is in the marked block.
  4249.      
  4250.        initial()
  4251.           Returns '1' if the function is called from the profile file.
  4252.      
  4253.        inprefix()
  4254.           Returns '1' if the cursor is located in the prefix area.
  4255.      
  4256.        leftedge()
  4257.           Returns '1' if the cursor is on the left edge of the file area.
  4258.      
  4259.        modifiable()
  4260.           Returns '1' if the cursor is located in an area that can be changed.
  4261.           ie. not on '*** Top of File ***' or '*** Bottom of File ***' lines.
  4262.      
  4263.        rightedge()
  4264.           Returns '1' if the cursor is on the right edge of the file area.
  4265.      
  4266.        spacechar()
  4267.           Returns '1' if the cursor is on a space character.
  4268.      
  4269.        tof()
  4270.           Returns '1' if the cursor is on the '*** Top of file ***' line
  4271.           and the cursor is not on the command line.
  4272.      
  4273.        topedge()
  4274.           Returns '1' if the cursor is on the top edge of the file area.
  4275.      
  4276.        verone()
  4277.           Returns '1' if the column 1 of the file is being displayed in
  4278.           column 1.
  4279.      
  4280.      OTHER FUNCTIONS
  4281.      
  4282.         The following functions provide functions to simplify THE macros
  4283.         written in REXX.
  4284.      
  4285.        valid_target(target)
  4286.           Returns 0 if the supplied 'target' is invalid.
  4287.           Returns 'ALL' if the supplied 'target' is 'ALL'.
  4288.           If a valid target, returns the number of lines from the focus
  4289.           line to the 'target', either positive if the target is toward the
  4290.           end of file or negative if the target is toward the top of file.
  4291.      
  4292.  
  4293.  
  4294.  
  4295.      --------------------------------------------------------------------------
  4296.      
  4297.      
  4298.      ========================================================================
  4299.      APPENDIX 1 - ENVIRONMENT VARIABLES
  4300.      ========================================================================
  4301.      
  4302.      THE uses the following environment variables:
  4303.      
  4304.              THE_HOME_DIR     - the directory in which THE looks for its help
  4305.                                 file(s) and macro(s);
  4306.              THE_HELP_FILE    - the fully qualified file name containing help
  4307.                                 information.
  4308.              THE_PROFILE_FILE - the fully qualified file name for the default
  4309.                                 profile file.
  4310.              THE_MACRO_PATH   - a list of all directories in which THE is to 
  4311.                                 look for macro files.
  4312.      
  4313.      The following defines how these environment variables are used under UNIX.
  4314.      
  4315.      If no environment variable; THE_HOME_DIR, is set prior to starting THE,
  4316.      THE uses /usr/local/THE/ (or /opt/THE/ if SYSVR4 is defined when compiling)
  4317.      as the default value for ${THE_HOME_DIR}. 
  4318.      This can be changed in the.c if necessary.
  4319.      
  4320.      The default value of THE_HELP_FILE is ${THE_HOME_DIR}${TERM}.hlp
  4321.      eg. with no environment variables set and $TERM set to vt220, the help 
  4322.      file to be looked for will be /usr/local/THE/vt220.hlp (or 
  4323.      /opt/THE/vt220.hlp if SYSVR4 is defined when compiling).
  4324.      If THE_HOME_DIR environment variable was set to /usr/opt/etc or changed in
  4325.      the.c, the help file will be /usr/opt/etc/vt220.hlp. If no $TERM 
  4326.      environment variable is set, "default" is used.
  4327.      
  4328.      The name of the default profile file is $HOME/.therc.
  4329.      
  4330.      The default value of THE_MACRO_PATH is ${THE_HOME_DIR}:. THE will look for 
  4331.      a macro file first in ${THE_HOME_DIR} and then in the current directory. 
  4332.      So with no environment variables set, THE looks for macros in 
  4333.      $(THE_HOME_DIR} first and if no file exists in that directory, THE will 
  4334.      look in the current directory. If the file does not exist in either of 
  4335.      these places, an error message will be displayed.
  4336.      The format of THE_MACRO_PATH is dir1:dir2:dir3 Each directory is seperated 
  4337.      by colons. By default, up to 20 directories may be specified. This can be 
  4338.      changed in the.h.
  4339.      
  4340.      The following defines how these environment variables are used under DOS 
  4341.      and OS/2.
  4342.      
  4343.      By default THE_HOME_DIR is set to the directory from which THE was 
  4344.      invoked. Assuming THE.EXE resides in d:\tools, THE_HOME_DIR will equate 
  4345.      to d:\tools\.
  4346.      
  4347.      The default value of THE_HELP_FILE is ${THE_HOME_DIR}dos.hlp for DOS and
  4348.      ${THE_HOME_DIR}os2.hlp for OS/2.
  4349.      
  4350.      The name of the default profile file is ${THE_HOME_DIR}profile.the.
  4351.      
  4352.      The default value of THE_MACRO_PATH is ${THE_HOME_DIR};. THE will look for
  4353.      a macro file first in THE_HOME_DIR and then in the current directory. So 
  4354.      with no environment variables set, THE first looks for macros in the 
  4355.      directory from which THE was invoked and then in the current directory. 
  4356.      If the file does not exist in either directory, an error message is displayed.
  4357.      The format of THE_MACRO_PATH is dir1;dir2;dir3 Each directory is seperated 
  4358.      by semi-colons. By default up to 20 directories may be specified. This can 
  4359.      be changed in the.h.
  4360.      
  4361.  
  4362.  
  4363.  
  4364.      --------------------------------------------------------------------------
  4365.  
  4366.  
  4367.  
  4368.  
  4369.  
  4370.